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P Rete te AC E 


This Handbook contains descriptions of the Paper Tape Software for 
the PDP-ll system. With this information you can load, dump, edit, assem- 
ble, and debug PAL-11A Assembly Language programs. Math routines and 
input/output functions are also available to facilitate your programming 
efforts. 


The table of contents in the front of the Handbook directs you to the 
chapter of the system program desired. There you will find a detailed 
table of contents for reference while working with that chapter. For 


locating items in still more detail, an Index concludes the Handbook. 


The following symbols, when used herein, have the indicated meanings: 


J denotes pressing the RETURN key, or indicates an ASCII 
carriage return; 


* denotes pressing the LINE FEED key, or indicates an 
ASCII line feed; i : 


A denotes pressing the SPACE bar, or indicates an ASCII 
space; , k 


—— 


-] denotes typing CTRL/TAB, or indicates an ASCII tab. 
Other documentation conventions are: 


1. Unless otherwise indicated, a line of user input is terminated 
` with the RETURN key. 


2. When the distinction is useful, system printout is underlined 
and user input is not underlined. 


3. CTRL/U denotes holding down the CTRL key while typing the U key, 
as when using the SHIFT/key combination. The slash is shown merely to 
tie the actions together.  CTRL is also used with certain other keys, 
e.g., CTRL/P. The use of the CTRL/key combinations usually prints a 4 


and the key typed, e.g., CTRL/U echoes tU on the printer when using ED-11 
or IOX. 
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CHAPTER 1 


PROGRAMMING THE PDP-11 SYSTEM 


1.1 INTRODUCTION 

The PDP-11 is a 16-bit, general-purpose, parallel-logic computer using 
two's complement arithmetic. Programmers can directly address 32,768 
l6-bit words, or 65,536 8-bit bytes. All communication between system 
components is done on a single high-speed bus called diy bnipus. 


Standard features of the system include eight general-purpose registers 


which can be used as: accumulators, index registers; or address pointers; 
and a multi-level automatic priori interrupt simplified 


block diagram of the PDP-1l System is presented in Figure 1-5 


This chapter gives the PDP-ll programmer an overview of system architec- - 
ture, points out unique hardware features, and presents programming 
concepts basic to the use of the PDP-1l. Following this is a short sum- 


mary of DEC-supplied PDP-11 software. 


1.2. SYSTEM FACILITIES 
The architecture of the PDP-11 system and the design of its central pro- 


cessor provide: 


€ single and double operand addressing 
€ full word and byte addressing 


e sinpblified list and stack processing through auto-address 
stepping (autoincrementing and autodecrementing) 


ə eight programmable general-purpose registers 
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® data manipulation directly within external device 
registers 


9 addressing of device registers using normal memory 
reference instructions 


9 asynchronous operation of memory, processor and 
I/O devices 


9 a hardware interrupt priority structure for peri- 
pheral devices , 


9 automatic interrupt identification without device 
polling i 


® cycle stealing direct memory access for high-speed > 
data transfer devices 


® direct addressing of 32K words (65K bytes). 


Two design features of the central processor serve to increase 


system throughput: > 


a. The eight programmable general-purpose registers than 
the central processor can be used to store data and 
intermediate results during the execution of a sequence 
of instructions. Register-to-register addressing 


provides reduced execution time for most instructions. 


b. The ability to code two addresses within a single 
instruction allows operations on data within memory. 
This eliminates the need to load processor registers 
prior to data operations, and greatly reduces fetch 


and store operations. 


1.3 STATUS REGISTER FORMAT 


The Central Processor Status Register (PS) contains in- 
formation on the current priority of the processor, the result 
of previous operations, and an indicator for detecting the 
execution of an instruction to be trapped during program de- i 
bugging. The priority of the central processor can be set 
under program control to any one of eight levels. This in- 
formation is held in bits 5, 6, and 7 of the PS. ‘Four bits 
are assigned to monitor different results of previous instruc- 


‘tions. These bits are set as follows: 


Z -- if the result was zero 

N -- if the result was negative 

.C -- if the operation resulted in a carry from 
the most significant bit l 

V -- if the operation resulted in an arithmetic. A i 


overflow 


The T bit is used in program debugging and can be set or 
cleared under program control. If this bit is set when an 
instruction is fetched from memory,a processor trap will 
occur at the completion of the instruction's execution. 
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Figure 1-2. Processor Status Register 


1.4  UNIBUS 


The Unibus is a key component of the PDP-ll's unique architecture. 
The Central Processor, memory, and all peripheral devices share 
the same bus. This means that device registers can be addressed 
as memory, and data transfers from input to output devices can 
by-pass the processor. No special I/O instructions exist. All 


PDP-1l instructions are available for I/O operations: 








CENTRAL 
PROCESSOR 










READ 
ONLY 
MEMORY 





READ/ WRITE : CUSTOMER 


Figure 1-3  PDP-11 System Unibus Block Diagram 





1.5 DEVICE INTERRUPTS 


Interrupt request lines provide for device interrupts at 

processor priority levels 4 through 7. Attachment of a device 

to a specific line determines the device's hardware priority. 
Since multiple devices can be attached to a specific line, the 
priority for each is determined by position; devices closer to the 


Central Processor have higher priority. 


Direct memory devices, such as disk units, transfer data at the 
Non-Processor Request level (NPR) which has a higher priority 
than the interrupt request lines. .Data transfers between such 


devices and core memory are overlapped with Processor operations. 
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Peripheral device interrupts are linked to specific core memory 
locations, or "interrupt vectors", in such a way that device 
polling is. eliminated. When an interrupt occurs, the interrupt 
vector supplies a new Processor Status word (i.e., new contents for 
the Processor Status register) and a new value for the Program 
Counter. The new PC value causes execution to start at the proper 


handler at the priority level indicated by the new Status register. 


1.6 INSTRUCTION SET 


The instruction set (explained fully in the PDP-11 Processor Handbook; 
Summarized in Appendix B of this manual) provides operations that 

act upon 8-bit bytes and 16-bit words. Coupled with varying 

address modes -- Relative, Index, Immediate, Register, Autoincrement, 

or Autodecrement, each of which can be deferred -- more than 499 

unique instructions are available. Instruction length is variable -- 
from one to three 16-bit words, depending upon the addressing 


4 E 
modeí(s) used. 


1.7 ADDRESSING 


Every byte has its own unique address. It is the instruction which 
determines whether 8-bit bytes or 16-bit words are being referenced. 

Words are addressed by their low-order (even-numbered) byte. 

Although byte addressing can be to odd- or even-numbered y | 
addresses, referencing words at odd-numbered addresses is illegal. 
Bits are numbered from 0 at the lowest order bit (29), to 15 (for 


a word) or 7 (for a byte) at the highest order bit ees or 25 


^4 
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reference to R0, Rl, etc., as well as SP and PC, assumes such prior 


Most data in programs is structured in some way; often by means of 

tables consisting of the data itself or of addresses which point to 

the d&a. The PDP-11 handles common data structures with operand address- 
ing modes specifically designed for each kind of access. In addition, 
addressing for unstructured data permits direct random access to all 

of core. The actual formats of the modes are described in Chapter 3, 


on the PAL-1l Assembler. 


1.7.l Registers 
Addressing in the PDP-11 is done through the general registers. These 


registers can be specified by preceding a number in the range 0 to 7 | 
with a $. However, it is common practice to assign to symbols the 


register identities; often R0-$0, Rl1-$1, etc. Throughout this manual, 


direct assignment. (See Chapter 3, Section 3.3.4.) All eight general 





registers are accessible to the programmer, but two of these have addi- 


"tional specialized functions (discussed below). R6 is the processor 


Stack Pointer (SP), and R7 is the Program Counter (PC). 


To make use of a register as an accumulator, index register, or sequential 
address pointer, data needs to be transferable to and from the register. 
This is accomplished with Register Mode, which specifies that the in- 


struction is to operate on the contents of the indicated register itself. 


For example: 


CLR R3 ;CLEAR REGISTER 3 OF ITS CONTENTS 








1.7.2 Address Pointers f 


The instruction can be made to interpret the register contents 
as the address of the data to be operated upon, by specifying that 


Register Mode be deferred. For example, if register 3 contains 1000 


CLR (R3) Or CLR @R3 


will clear the address 1000. Moreover, if it is desired to perform 
the instruction successively upon data at sequential — (i.e., 
in a table), Autoincrement Mode can be dee uted, This will auto- 
matically increment the contents of the register, after its use as a 
pointer to the next sequential byte or word address. Note that Auto- - 
increment Mode (as well as Autodecrement Mode, mentioned below) is 


automatically deferred one level to cause the register contents to 


function as a pointer. ( 


When it is specified that Autoincrement Mode be deferred, it is de- 
ferred two levels so that the instruction interprets the autoincremented 
sequential locations as a table of addresses rather than as a table of 
data, as in nondeferred Autoincrement Mode. The instruction then 


operates upon the data at the addresses specified by the table entries. 


Each execution of the following ADD instructions increments the value 
of the register contents by two, to the next word address (always an 


even number). 


ACCUM: ADD (R@)+,(R1)+ ;IF RØ INITIALLY CONTAINS 1999, 


. ;AND Rl INITIALLY CONTAINS 1459, 

. ;THE VALUES AT LOCATIONS 1ggg, ; 
. 71992, ETC., ARE ADDED TO THOSE AT 
. ;LOCATIONS 145g, 1452, ETC., AND 


. ; THE RESULT STORED AT 1459, ETC. 
JMP ACCUM 


ACCUM: ADD @(R3)+,R2 ;IF R3 INITIALLY CONTAINS 1999, 
; ;AND LOCATION 1999 CONTAINS 342f, 
; THE VALUE AT LOCATION 3429 IS 
" ;ADDED TO THE CONTENTS OF R2 AND 
r ; THE RESULT IS STORED THERE. AT 
;NEXT EXECUTION OF THE INSTRUC- 
; ;TION, R3-1992. 
JMP ACCUM 
Byte instructions (such as TSTB (R2)+) using Autoincrement 


Mode, increment the register contents by one. 


In addition to this capability of incrementing a register's 
contents after their use as a painters an address mode comple- 
mentary to this exists. Autodecrement Mode decrements the contents 
of the specified register before the contents are used as a 
pointer. This mode, too, can be deferred an additional level if 


the table contains addresses rather than data. == 


ies. Stack Operations 


Both Autoincrement and Autodecrement Modes are usėd in stack 
A AA Stacks, also called push-down or LIFO (Last-In- 
First-Out) lists, are important for temporarily saving values 
which might otherwise be altered. Their characteristic is that 
the most recent piece of data saved is the first to be restored. 
The PDP-1l processor makes use of stack structure to save and 
restore the state of the machine on interrupts, traps, and sub- 
routines (see below). To save, data is "pushed" onto a stack 

by autodecrementing the contents of a register (e.g., MOV R3,-(R6)); 
to restore, data is "popped" from a stack by autoincrementing 
(e.g., MOV (R6)+,R3). The register being used as the Stack 


Pointer always points to the top word of the stack.: 
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EO E1 
1. AN EMPTY 2. PUSHING A 3.PUSHING ANOTHER 
STACK DATUM ONTO DATUM ONTO THE 
THE STACK STACK 
E2 E2 ES E3 


4. ANOTHER 5. POP 6. PUSH 7T. POP 
PUSH ` 


Figure l-4. Illustration of Push and Pop Operations 
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1.7.4 Random Access of Tables 


Direct access to an entry in the middle of a stack, or indeed 

any kind of table, is accomplished through Index Mode. The 

contents of a register are added to a base (fetched from ttn f 
word or second word following the instruction) to calculate an 


address. With this facility, a fixed-order element of several 


P tables, or several elements of a single table may be accessed.: 


addresses e.g., if R3 i 
TABLE OF WORDS of entries contains Operand code is: 


TBLl1: €- TBLl1 g 
€- TBL1+2 2 
é- TBL1+4 4 TBL1(R3) 
&— TBL1+6 6 in each case 
é- TBL1+19 1g 


When deferred Index Mode is specified (e.g., @TBL1(R3)), the 
calculated address contains a pointer to the data, rather than 


the data itself. Byte tables are discussed in Section 1.8. 


a 
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1.7.5 Summary of Address Modes 


The address modes may now be summarized as follows: 


Assembler 


Syntax 


Rn 
(Rn) + 


- (Rn) 


A(Rn) 


' Assembler 
Syntax 


&Bn or (Rn) 
@(Rn)+ 


@- (Rn) 


GA LRS) 


Non-deferred Modes 





Mode Typical Use 

Register, Accumulator 

Autoincrement Sequential pointer to data 
in a table; popping data 
off a stack 

Autodecrement Sequential pointer to data in 
a table; pushing data on a stack. 

Index Random access to stack or 
table entry. o 

Deferred Modes 
Mode Typical Use 
Deferred Register Pointer to an address 


Deferred Auto- 
increment 


Deferred Auto- 
decrement 


Deferred Index 


Sequential pointer to addresses 
in a table; popping address 
pointers off a stack. ` 

Sequential pointer to addresses 
in a table; pushing address 
pointers on a stack 

Random access to table of 
address pointers. 


1.7.6 Accessing Unstructured Data 


Addressing of unstructured data becomes greatly facilitated through 


lel 








the use of the Program Counter (R7) as the specified register in 
these modes. This is particularly true of Autoincrement and Index 
Modes, which are mentioned below, but discussed more fully in Chapter 3, 


the PAL-11 Assembler. 


Autoincrement Mode using R7 is the way immediate data is assembled. 
This mode causes the operand itself to be fetched from the word (or 
second word) following the instruction. It is designated by preceding 
a numeric or symbolic value with #, and is known as Immediate Mode. 
The instruction 

ADD #58,R3 
causes the value 5B to be added to the contents of register d 
If the # is preceded by @, the immediate data is interpreted ag “an 
absolute address, i.e., an address that remains constant no matter 


where in memory the assembled instruction is executed. 


Index Mode using R7 is the normal way memory addresses are assembled. 

This is relative addressing because the number of byte locations between 
the Program Counter (which contains the address of the current word+2) 

and the data referenced (destination minus PC) is placed in the word (or 
second word) following the instruction. It is this value that is indexed 
by R7 (the Program Counter). ((Destination-PC)+PC=Destination.) Relative 
Mode is designated by specifying a memory location either numerically or 
symbolically (e.g., TST 198 or TST A). If a memory address specifica- 
tion is preceded by G8, it is in deferred Relative Mode and the contents 

of the location are interpreted by the instruction as a pointer to the 


address of the data. 


a 





1.8 INSTRUCTION CAPABILITY 


The twelve ways of specifying an operand demonstrate the 
flexibility of the PDP-11 in accessing data according to how it 
is structured, and even if it is not structured. Each instruc- 
tion.adds to this versatility by acting on an operand in a way 
particularly suited to its task. For example, the task of 
adding, moving, or comparing implies the use of two operands in 


any of the twelve addressing forms; whereas the task of clearing, 





testing, or negating implies only one operand. Examples: 


ADD #12,GROUP (R2) CLR R3 
MOV MEM1,MEM2 TST SUM A 
CMP (R4)+,VALUE NEG Q-(R5) f 


Some instructions have counterparts which operate on byte data 
rather than on full words. These byte instructions are easily 
recognized by the guttixiens of the letter B to the word instruc- 
tion. MOV is one such word instruction; e.g., MOVB #12,GROUP(R2) 
would move an 8-bit value of 128 to the 8-bit byte at the address 
Specified. One implication of byte instructions is that in 
Autoincrement or Autodecrement Mode, a table of bytes is being 
scanned. The Autoincrement or Autodecrement therefore goes by 
one in byte instructions, rather than by two. However, because 
of their specialized processor functions, R6 and R7 in these 


modés always increment or decrement by two. 


Forms other than single- or double-operand instructions include 
Operate instructions such as HALT and RESET, which take no 
operands; Branch instructions, which transfer program control 
under specified conditions (see Section 3.7); Subroutine calls 
and returns; and Trap instructions (see Appendix B for complete 


instruction set). 
1.9 PROCESSOR USE OF STACKS 


Because of the nature of last-in-first-out data structures, the 
same stack can be used to nest multiple levels of interrupts, 


‘traps, and subroutines. 
1.9.1 Subroutines. 


In Subroutine calls (JSR Reg,Dest) the contents of the specified 
register are saved on the stack (the processor always uses R6 

as its Stack Pointer) and the value of the PC (return address 
following subroutine execution) becomes the new value of the 
register. This allows any arguments following the call to be 
referenced via the register. The command RTS Reg causes the 
return from the subroutine by moving the register value into the 
PC. It then pops the saved register contents back into the 
register. (Return from a subroutine is made through the same 


register that was used in its call.) 


1.9.2 Interrupts 


When the processor acknowledges a device interrupt request, the 
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device sends an interrupt vector address to the processor. The 
processor then pushes the current Status (PS) and PC onto the 

stack and picks up a.new PS and PC (the interrupt vector) from 

tne address specified by the device. Another acknowledged interrupt 
before dismissal will cause the PS and PC of the running device 
service routine to be pushed onto the stack and the address and 
status of the new service routine to be loaded into: the PC and PS. 

A process can be resumed by popping the old PC and PS from the Stack 


into the current PC and PS with the Return from Interrupt (RTI) 


instruction. 
di. 91 53 Traps 


Traps are processor generated interrupts. Error conditions, 
certain instructions, and the completion of an instruction fetched 
while the T bit was set cause traps. As in interrupts, the 
current PC and Status are saved on the stack and a new PC and 
Status are loaded from the appropriate trap vector. The ingbrup- 
tion RTI provides for a.return from an interrupt or trap by 


popping the top two words of the stack back into the PC and PS. 





1. PROCESS O IS o 4 PROCESS 1 [v] 
RUNNING STACK 4 INTERRUPTED x 
POINTER (SP) ve WITH PC=PCy 00 
POINTING TO AND STATUS= PS}. 
LOCATION PO. PROCESS IS 

SP—PO 
PROGRAM STARTED. db 


2|NTERRUPT STOPS o 
(PROCESS O WITH 400 
PC:PCo AND 
STATUS = PSo 
STARTS PROCESS 1. 

SP-- 


PO|PROGRAM 


5.PROCESS 2 o 
COMPLETES WITH 400 
A RTI INSTRUCTION 
(DISMISSES 
INTERRUPT) 

PC IS RESET SP— 
TO PC, AND 
STATUS IS RESET 
TO PS}. 
PROCESS 1 RESUMES. 












3 PROCESS 1 USES 
STACK FOR 400 
TEMPORARY 
STORAGE (TE, TE4). 


6.PROCESS 1 
RELEASES THE 400 
TEMPORARY 
STORAGE HOLDING 
TEO AND TE}. 





7 PROCESS 1 COMPLETES o 
ITS OPERATION WITHA 400 
RTI. 

PC IS RESET TO PCo 
AND STATUS 1S 
RESET TO PSọ- 
PROCESS O RESUMES. 


SP-—ePO 





Figure 1-5. Nested Device Servicing 


1.10 PAPER TAPE SYSTEM SOFIWARE 


The paper tape system and utility programs described herein require 


t least 4K of core memory (except for the 8K version of the 


PAL-11A Assembler) and an ASR-33 Teletype. 


2 1-16 


An optional high-speed paper-tape reader and punch is available, 
as is a line printer. The operation of these input/output devices 


is explained in Chapter 2. 


Following are abstracts of the paper-tape software programs des- 


cribed in this handbook. 


d. Bootstrap Loader -- used to load into core memory, 
programs punched on paper tape in bootstrap format. 
It is primarily used to load the Absolute Loader and 
Dump programs (see Chapter 6). | 
2. Absolute Loader -- used to load into core memory, 
programs punched on paper tape in absolute binary 
format. This not only includes the binary tapes of 
subsequently listed programs but also any user program 
assembled using the PAL-11A Assembler or dumped by. 
the DUMPAB program (see Chapter 6). 
3. PAL-11A -- the absolute assembler for PDP-1ll Paper 
Tape Software system (see Chapter 3). 
4. ED-1ll -- the text editor for the PDP-11 Paper Tape 
Software system. It is primarily intended for use 
in producing source program tapes, but may be used 
for any text generating and editing purposes (see 
Chapter 4). 
5.  ODT-ll and ODT-11X -- these are on-line debugging 
programs, enabling you to check out any object program. 
You can run all or any portion of an object program, 
and make corrections or modifications to it by typing 


commands to ODT while at the Teletype (see Chapter 5). 
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IOX -- which stands for Input/Output Executive, provides asyn- 
chronous I/O service for Teletype I/O devices and the high- 
speed paper tape readerand punch. (IOXLPT allows also for a 
line printer.) It enables you to write simple I/O requests 
specifying devices and data forms to accomplish interrupt- 
controlled data transfer concurrently with the execution of a 
running user program. It is an integral part of PAL-11A and 


ED-11 (see Chapter 7). 


FPMP-ll--which stands for Floating-Point and Math Package, 
PDP-ll, is a comprehensive set of subroutines which enable 


you to perform arithmetic operations. The subroutines may 


be used by any PDP-11 object program (see Chapter 8 for overview). i 


— r 


DUMPTT and DUMPAB -- are core dump programs which provide 


dumping of specified areas of core either in octal on the 


Teletype or in absolute binary on paper tape (see Chapter 6). 
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CHAPTER 2 


THE SYSTEM CONFIGURATION 


This chapter explains the operation of the computer console, Teletype, 


high-speed reader/punch, and line printer. 


2.1 PDP-1l CONSOLE 


The PDP-11 console is designed to achieve convenient control of the system. 
Through switches and keys on the console, programs and information can be 
manually inserted or modified. Indicator lamps display the status of the 
computer at all times. The PDP-11 console is shown in Figure 2-1, and each 
Switch, key, and display lamp is explained beiow. 
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jen ——— 
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Figure 2-1. The PDP-11 Console 





[d a E E E NOS Coo DN, o1 0, OO ee ee EDR, 


2.1.1 Elements of the Console 


The console has the following indicators and switches: 


1. A bank of eight indicators, indicating the following con- 
ditions or operations: 


a. Fetch 
b. Execute 
c. Bus 

d. Run 


e. Source 
f. Destination 
g. Address (two bits) 





2. An 18-bit ADDRESS REGISTER display 
3. A 16-bit DATA Register display 

4. An 18-bit Switch Register 

5. Control Switches: 


a. LOAD ADDR (Load value set in Switch Register into 
address register) 


b. EXAM (Examine contents of location) 
c. CONT (Continue execution) 
d.  ENABLE/ . 

HALT (Enable or halt execution) 


e. ` S-INST/ (Single Instruction-Single 
S-CYCLE Cycle execution) 


£. START (Start execution) 


g. DEP (Deposit value set in Switch Register 
into specified memory location) 


2.1.1.1 Register Displays 


The operator's console has an 18-bit ADDRESS REGISTER display and a 16-bit 
DATA Register display. The ADDRESS REGISTER display is tied directly to 
the output of an 18-bit flip-flop register called the Bus Address Register. 


This register displays the address of data examined or deposited. 


2.1.1.2 Switch Register. 


The PDP-11 is capable of referencing 16-bit addresses. However, the Unibus 
has expansion capability for 18-bit addresses. Therefore, to access the 
entire 18-bit address scheme, the Switch Register is 18-bits wide. These 

bits are assigned as 0 through 17. The highest two bits are used only for 
addressing. 


A switch in the up position is considered to have a 1 value. A switch 
in the down position is considered to have a 0 value. The condition of the 
switches can be loaded into the ADDRESS REGISTER or any memory location 


using the appropriate control switch described below. 


1. LOAD ADDR Transfers the contents of the 18-bit 
Switch Register into the ADDRESS REGIS- 
TER. 

2. EXAM Displays the contents of the location 


specified by the ADDRESS REGISTER. 


Ja DEP Deposits the contents of the low-order 
16-bits of the Switch Register into 
the address displayed in the ADDRESS 
REGISTER. (This switch is actuated by 
raising it.) 


4.  ENABLE/HALT Allows or prevents running of programs. 
For a program to run, the switch must 
be in the ENABLE position (up). Placing 
the switch in the HALT position (down) 
will halt the system at the end of the. 
current instruction or cycle, depending 
on the position of the S-INST/S-CYCLE 
switch. 


Sea START Begins execution of a program when the 
ENABLE/HALT switch is in the ENABLE 
position. When the START switch is de- 
pressed it asserts a system initializa- 
tion signal, actually starting the sys- 
tem when the switch is released. The 
processor will start executing at the 
address which was last loaded by the 
LOAD ADDR switch. 


6. CONT Allows the computer to continue with- 
out initialization from whatever state 
it was in when halted. 


7. S-INST/S-CYCLE Determines whether a single instruction 
or a single cycle is performed when the 
CONT switch is depressed while the com- 
.puter is in the halt mode. 


When the system is running a program, the LOAD ADDR, EXAM, and DEPosit 
functions are disabled to prevent disrupting the running program. 


2.1.1.3 Indicator Lights 


The indicator lights signify specific computer functions, operations, or 
states. Each is explained below. 


ds FETCH Indicates that the central processor is 
in the state of fetching an instruction. 


2. EXECUTE Indicates that the central processor is 
in the state of executing an instruction. 


3.- BUS Indicates that a peripheral is controlling 
the bus. It is lit when Bus Busy (BBSY) 
is asserted, unless the processor (includ- 

ing the console) is asserting BBSY. 
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5. SOURCE 


» 


pes 


6. DESTINATION 


7. ADDRESS 





.ndicates that the processor is running. 
(Waile executing a RESET command [20 ms.] 
the RUN light is not on.) 


Indicates that the central processor is 
obtaining source data. (Not lit when 
data is from an internal register.) 


Indicates that the central processor is 
obtaining destination data. (Not lit 
when data is from an internal register.) 


Identifies the source or destination ad- 
dress cycle of the central processor. 

When references to the addresses are made 
via the Unibus, the lights tell the com- 
puter's source or destination cycle. For | 
an internal register reference, the address 
is always zero. 


2.1.2 Operating the Control Switches 


When the PDP-11 has been halted at the end of an instruction, it is possible 
to examine and update the contents of locations. (You cannot EXAMine or 


DEPOsit at the end of a single cycle unless the cycle coincides with the 


end of the instruction.) To examine a specific location, set the Switch 


Register to correspond to the location's address, and press LOAD ADDR, 
which will transfer the contents of the Switch Register into the ADDRESS 
REGISTER. The location of the address to be examined is then displayed 


in the ADDRESS REGISTER. 


You can then depress EXAM, and the data in that 


iocation will appear in the DATA register. 


If you attempt to examine data from or deposit data into a nonexistent 


memory location, an error will occur and the DATA register will reflect 


location 000004, the trap location for references to nonexistent locations. 


To verify this condition, deposit some number other than four in the loca- 


tion. If four is still indicated, either nothing is assigned to that loca- 


tion or whatever is assigned is not working properly. 


By depressing EXAM again, the ADDRESS REGISTER will be incremented by 
two to the next word address, and the contents of this next location may be 
examined. The ADDRESS REGISTER will always indicate the address of the 
data displayed in the DATA register. 


The examine function is such that if LOAD ADDR is depressed and then 
EXAM, the ADDRESS REGISTER will not be incremented. In this case, the 
location reflected in the ADDRESS REGISTER is examined directly. However, 
on successive depressings of EXAM only, the ADDRESS REGISTER is incremented. 


T= you find an incorrect entry in the DATA register, you can enter the 
correct data there by putting it in the Switch Register and raising the 

DEP switch. The ADDRESS REGISTER will not increment when this data is 
deposited: Therefore, by pressing the EXAM switch you can examine (verify) 
the data just deposited. However, pressing EXAM again will increment the | 


register to the next word address. 


When doing consecutive examines or deposits, the address will incre- 
ment by two, to successive word locations. However, when examining the 
general-purpose registers (RO-R7), the system only increments by one. 

The reason for this is that once the Switch Register is set properly, you 
can use the automatic stepping feature of EXAM to examine general-purpose 
registers from the computer console. l 

l To start a program after it is loaded into core, load the starting 
address of the program into the Switch Register, press LOAD ADDR, and 
after ensuring that the ENABLE/HALT switch is in the ENABLE position, de- 
press START. The program should start to run as soon as the START switch 


is released. 


Normally, when. the system is running, not only will the RUN light be 
on but other lights (FETCH, EXECUTE, SOURCE, etc.) will be flickering. If 
the RUN light is on and none of the other lights are flickering, the system 
could be executing a WAIT instruction which waits for an interrupt. 


while in the halt mode, if you wish to do a single instruction, place 
the S-INST/S-CYCLE switch in the S-INST position and depress CONT. When 
CONT is pressed, the console momentarily passes control to the processor, 
allowing it to execute one instruction before regaining control. Each time 
the CONT switch is pressed the computer will execute one instruction. If 
1 wish to have the computer perform a single cycle, place the S-INST/S- 
YCLE switch in the S-CYCLE position and press CONT. The computer will 


then perform one complete cycle and halt. 





To start the program again, place the ENABLE/HALT switch in the ENABLE 
position and press CONT. [ 


2.2 OPERATING THE TELETYPE 


The ASR-33 Teletype (TTY) is the basic input/output device for PDP-11 com- 
puters. It consists of a printer, keyboard, paper tape reader, and paper 

tape punch, all of which can be used either on-line under program control or 
off-line. The. Teletype controls (Figure 2-2) are described as they apply Lu 
to the operation of the computer. 


STOP - 
FREE - 





OFF 
Line (C) tocar 


(TTY switch) 
Figure 2-2. ASR-33 Teletype Console 


2.2.1 Power Controls 


LINE B The Teletype is energized and connected to 
the computer as an input/output device, under 
computer control. 


OFF - The Teletype is de-energized. 
LOCAL = The Teletype is energized for off-line opera- 
tion. 


2.2.2 Printer 


The printer provides a typed copy of input and output at 10 characters per 


second, maximum. 


2.223 Iorbaerd 


The Teletype keyboard is similar to a typewriter keyboard. However, cer- 
tain operational functions are shown on the upper part of some of the key- 
tops. These functions are activated by holding down the CTRL key while 
depressing the desired key. For example, when using the Text Editor, 


CTRL/U causes the current line of text to be ignored. 


Although the left and right square brackets are not visible on the 
keyboard keytops, they are shown in Figure 2-3 and are generated by typing 
SHIFT/K and SHIFT/M, respectively. The ALT MODE key is identified as ESC 
(ESCape) on some keyboards. 


(00 00.00 O0. 0O O0 
eoooceceeoooooee — 
eooeoeoeoooeoeoee 


00000000000 
[ *a wmm "Jj nd 





Figure 2-3.  ASR-33 Teletype Keyboard 


'2.2.4 Paper Tape Reader 





| The paper tape reader (LSR) is used to read data punched on eight chan- 
nel perforated paper tape at a rate of 10 characters per second, maxi- 
mum. The reader controls are shown in Figure 2-2 and described below. 


START Activates the reader; reader SMEs tn wheel 
is engaged and operative. 


STOP Deactivates the reader; reader sprocket wheel 
is engaged but not operative. 


FREE Deactivates the reader; reader sprocket wheel 
is disengaged. | 





The following procedure describes how to properly position paper tape 


in the low-speed reader. 


a. Raise the tape retainer cover. 
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b. Set reader control to FREE. 

c. Position the leader portion of the tape over the read 
pens with the sprocket (feed) holes over the sprocket 
(feed) wheel and with the arrow on the tape (printed 
or cut) pointing outward. 

d. Close the tape retainer cover. 


e. Make sure that the tape moves freely. 


f. Set reader control to START, and the tape will be read. 


2.2.5 Paper Tape Punch 

The paper tape punch (LSP) is used to perforate eight-channel rolled 
oiled paper tape at a maximum rate of 10 characters per.second. The 
punch controls are shown in Figure 2-2 and described below. 


RELease Disengages the tape to allow tape removal or 
loading. 
B.SP Backspaces the tape one space for each firm 


depression of the B.SP button. ANE 
ON (LOCK ON) Activates the punch. 


OFF (UNLOCK) Deactivates the punch. 
Blank leader/trailer tape is generated by: 


l. Turning the TTY switch to LOCAL 
2. Turning the LSP on 

. 3. Typing the HERE IS key 
4. Turning the LSP off 


5. Turning the TTY switch to LINE. 


2.3 OPERATING THE HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 


A high-speed paper tape reader and punch unit is pictured in Figure 2-4 


and descriptions of the reader and punch units follow. 


2.3.1 Reader Unit 


The high-speed paper tape reader is used to read data from eight-channel 
Zan-folded (non-oiled) perforated paper tape photoelectrically at a maxi- 
mum rate of 300 characters per second. Primary power is applied to the 

reader when the computer POWER switch is turned on. The reader is under 


rogram control. However, tape can be advanced past the photoelectric 


ET 


sensors without causing input by pressing the reader FEED button. 


2.3.2 Punch Unit 


The high-speed paper tape punch is used to record compüter output on eight- 
channel fan-folded paper tape at a maximum rate of 50 characters per second. 
All characters are punched under program control from the computer. Blank 
tape (feed holes only, no data) may be produced by pressing the FEED button. 
Primary power is available to the punch when the computer POWER switch is 
turned on. 





PAPER TAPE OFF LINE 


Figure 2-4. High-Speed Paper Tape Reader/Punch 


Paper tape is loaded into the reader as explained below. 


Raise tape retainer cover. 


H 
. 


2. Put tape into right-hand bin with channel one of 
the tape toward the rear of the bin. 


Place several folds of blank tape through the 
reader and into the left-hand bin. 


C 
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4. Place the tape over the reader head with feed 
holes engaged in the teeth of the sprocket wheel. 


5. Close the tape retainer cover. 


6. Depress the tape feed button until leader tape is 
over the reader head. 


CAUTION 


Oiled paper tape should not be used 

in the high-speed re&der or punch - 

oil collects dust and dirt which can 
cause reader or punch errors. 


2.4 THE LPll LINE PRINTER 


The LPll is a line printer with 80 column capacity, capable of printing 
more than 300 lines per minute at a full 80 columns, and more than 1100 
lines per minute at 20 columns. The print rate is dependent upon the data 


and the number of columns to be printed. I 


Characters are loaded into the printer memory via the Line Printer 
Buffer (LPB) serially. When the memory becomes full (20 characters) the 
characters are automatically printed. This continues until the 80 columns 
have been printed or a carriage return, line feed, or form feed character 


is recognized. 


t 


Figure 2-5 illustrates the printer control panel on which are mounted 


three indicator lights and three toggle switches. 


ON LINE 


© 


OFF LINE 





Figure 2-5. Line Printer Control Panel 
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Operation of the lights and switches is as. follows: 


POWER light 


READY light 


ON LINE light 


ON/OFF (main power) switch 


TOP OF FORM switch 


PAPER STEP switch 


ON LINE/OFF LINE switch 


. 


Glows red to indicate main power switch 
(located inside cabinet) is at ON posi- 
tion and power is available to the printer. 


Glows white, shortly after the POWER light 
goes on to indicate that internal compon- 
ents have reached synchronous state and 
the printer is ready to operate. 


Glows white to indicate that ON LINE/OFF 
LINE toggle switch is in ON LINE position. 


This switch controls line current +o the 
printer. |. To gain access to it, the printer 
front panel is unlatched, by pushing the 
circular button on the right hand edge, 

and opened to the left on its hinges. The 
switch is located to the left of center 
approximately fourteen inches below the 
top. If power is available, the red POWER 
light on the control panel will glow when 
the switch is positioned at ON. | 


The switch is on when in the up position. 
The ON and OFF labels are printed on the 
stem of the switch. A group of two switches 
and three indicator lights, above the main 
power switch, are for the use of techni- 
cians in making initial adjustments to the 
printer. 


This switch is tipped toward the front of 
the cabinet to roll up the form to the top 
of the succeeding page. It is spring re- 
turned to center position, and produces a 
single top-of-form operation each time it 
is actuated. The switch is effective only 
when the printer is off line. 


Operates similarly to TOP OF FORM but pro- 
duces à single line step. each time it is 
actuated. It is only effective with 
printer off line. 


This two-position toggle switch is spring- 
returned to center. When momentarily posi- 
tioned at ON LINE it logically connects the 
printer to the computer and causes the ON 
LINE light to glow.  Positioned momentarily 
at OFF LINE, the logical connection to the 
computer is broken, the ON LINE light goes 
off, and the TOP OF FORM and PAPER STEP 
switches are enabled. 


Zl 








2.5 ‘INITIALIZING THE SYSTEM 


“ Before using the computer system, it is good practice to initialize all units 


as specified below. 


a. Main power cord is properly plugged in 
b. Computer POWER key is ON 
c. Console switches are set: 


ENABLE/HALT to HALT 
SR=000000 


d. Teletype is turned to LINE 
e. Low-speed punch is OFF 
f. Low-speed reader is set to FREE 


g. High-speed reader/punch is ON 


The system is now initialized and ready for your use. 


Loading: are 
Initial Dialogue: 








CHAPTER 3 


WRITING PAL-11A ASSEMBLY LANGUAGE PROGRAMS 


PAL-11A (Program Assembly Language for the PDP-ll's Absolute Assembler) is 
the "heart" of the PDP-11/20 Paper Tape Software system. It enables you 
to write source (symbolic) programs using letters, numbers, and symbols 
which are meaningful to you. The source programs, generated either on- 
line using the Text Editor (ED-11), or off-line, are then assembled into 
object programs (in absolute binary) which are executable by the computer. 
The object program is produced after two passes through the Assembler; an 





optional third pass produces a complete octal/symbolic listing of the as- 
sembled program. This listing is especially useful for documentation and 


debugging purposes. 


This chapter explains not only how to write PAL-11A programs but 
also how to assemble the source programs into computer-acceptable ob- 
ject programs. All facets of the assembly language.are explained and 
illustrated with many examples, and the chapter concludes with assem- 
bling procedures. In explaining how to write PAL-11A source programs 
it is necessary, especially at the outset, to make frequent forward 
references. Therefore, we recommend that you first read through the: 
entire chapter to get a "feel" for the language, and then reread the 
chapter, this time referring to appropriate sections as indicated, for 
a thorough understanding of the language and assembling procedures. 


Some notable features of PAL-11A are: 


l. Selective assembly pass functions 
2. Device specification for pass functions 
3. Optional error listing on Teletype 
Double buffered and concurrent I/O (provided by IOX) 
5. Alphabetized, formatted symbol table listing l 


. The PAL-11A Assembler is available in two versions: a 4K version and 


an 8K version. 


The assembly language applies equally to both versions. The 4K ver- 
sion provides symbol storage for about 176 user-defined symbols, and the 
8K version provides for about 1256 user-defined symbols (see Section 3.3). 


Jer 
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In addition, the 8K version allows a line printer to be used for the pro- 


gram listing and/or symbol table listing. 


The following discussion of the PAL-11A Assembly Language assumes 
that you have read the PDP-11 Processor Handbook, with emphasis on those 
Sections which deal with the PDP-1l instruction set, formats, and tim- 
ings -- a thorough knowledge of these is vital to efficient assembly 


language programming. 


3.1 CHARACTER: SET 


A PAL-11A source program is composed of symbols, numbers, expressions, l 


, symbolic instructions, assembler directives, argument separators, and line 


terminators written using the following ASCII characters. 


l. The letters A through Z. (Upper and lower case letters 
are acceptable, although upon input, lower case letters 
will be converted to upper case letters.) 


2. The numbers 0 through 9. H 


3. The characters . and $ (reserved for system software). 


4. The separating or terminating symbols: 


:28480()0,;""'-81! 
carriage return tab space line. feed form feed 
3.2 STATEMENTS d 


A source program is composed of a sequence of statements, where each state- 

ment is on a single line. The statement is terminated by a carriage return 
character and must be immediately followed by either a line feed or form. 

feed character. Should a carriage return character be present and not be 
followed by a line feed or form feed, the Assembler will generate a Q 

error (Section 3.10) and that portion of the line following the carriage 

return will be ignored. Since the carriage return is a required statement 
terminator, a line feed or form feed not immediately preceded by a carriage f 


return will have one inserted by the Assembler. 


It should be noted that, if the Editor (ED-11) is being used to create 
the source program (see Section 4.4.4), a typed carriage return (RETURN 
lascir stands for American Standard Code for Information Interchange. 
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key) automatically generates a line feed character. 


A statement may be composed of up to four fields which are identified 
by their order of appearance and by specified terminating characters as ex- 


plained below and summarized in Appendix B. The four fields are: 
Label Operator Operand Comment 


The label and comment fields are optional. The operator and operand 
fields are interdependent -- either may be omitted depending upon the con- 


tents of the other. 


3.2.1 Label 


A label is a user-defined symbol (see Section 3.3.2) which is assigned the 
value of the current location counter. It is a symbolic means of referring 
to a specific location within a program. If present, a label always occurs 
first in a statement and must be terminated by a colon. For example, if 


— 


the current location is 10057 the statement 
ABCD: MOV A,B 


will assign the value 100, to the label ABCD so that subsequent reference 
to ABCD will be to location 100g. More than one label may appear within 
a single label field; each label within the field will'have the same value. 
For example, if the current location is 100, multiple labels in the state- 


ment 
ABC: SDD: A7.7* MOV A,B 


will equate each of the three labels ABC, $DD, and A7.7 with the value 
100,. ($ and . are reserved for system software.) 

The error code M (multiple definition of a symbol) will be generated 
during assembly if two or more labels have the same first six characters. 


3.2.2 . Operator 


An operator follows the label field in a statement, and may be an instruc- 
tion-mnemonic or an assembler directive (see Appendix B). When it is an 


instruction mnemonic, it specifies what action is to be performed on any 


- 


ge 
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operand(s) which follows it. When it is an assembler directive, it speci- 


fies a certain function or action to be performed during assembly. 


The operator may be preceded only by one or more labels and may be 


. followed by one or more operands and/or a comment. An operator is legally 


terminated by a space, tab, or any of the following characters. 


$ +.- G ( " ' $S | & , ; 
line feed form feed carriage return 


‘The use of each character above will be explained in this chapter. 
Consider the following examples: 


MOV A,B ;-] (TAB) terminates operator MOV 
MOV@A,B ;8 terminates operator MOV 
When the operator stands alone without an operand or comment, it is. 
terminated by a carriage return followed by a line feed or form feed charac- 


ter. 


3.2.3 Opverand: 


An operand is that part of a statement which is operated on by the opera- 
tor -- an instruction mnemonic or assembler directive.  Operands may be 
.symbols, expressions, or numbers. When multiple operands appear within a 
Statement, each is separated from the next by a comma. An operand may be 
preceded by an operator and/or label, and followed by a comment. 


The operand field is terminated by a semicolon when followed by a 
comment, or by a carriage return followed by a line feed or form feed 
character when the operand ends the statement. For example, 

LABEL: MOV GEORGE,BOB ; THIS IS A COMMENT 
where the space between MOV and GEORGE terminated the operator field and 
began the operand field; the comma separated the operands GEORGE and BOB; 


the semicolon terminated the operand field and began the comment. 
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3.2.4 Comments 


The comment field is optional and may contain any ASCII character except 
null, rubout, carriage return, line feed or form feed. All other charac- 
ters, even those with special significance are ignored by the Assembler 


when used in the comment field. 


The comment field may be preceded by none, any, or all of the other 
three fields. It must begin with the semicolon and end with a carriage 
return followed by a line feed or form feed character. For example, 


LABEL: CLR HERE ;THIS IS A $1.00 COMMENT 


Comments do not affect assembly processing or program execution, but 
they are useful in program listings for later analysis, checkout or docu- 


mentation purposes. 


3.2.5 Format Control 


The format is controlled by the Space and tab characters. . They have no | 
effect on the assembling process of the source program unless they are em- - | 
bedded within a symbol, number, or ASCII text; or are used as the operator | 
field terminator. Thus, they can be used to provide a neat, readable pro- | 
gram. A statement can be written 


LABEL:MOV(SP)-*,TAG;POP VALUE OFF. STACK 
or, using formatting characters it can be written 
LABEL: MOV (SP)+,TAG ;POP VALUE oF STACK 
which is much easier to read. 
Page size is controlled by the form feed character. A page of n lines 
is created by inserting a form feed (CTRL/FORM keys on the keyboard) after 


the nth line. If no form feed is present, a page is terminated after 56 


lines, 


C Mec | Symbols 


Thete are two types of symbols, permanent and user-defined. Both are. 


: | 3-5 


stored in the Assembler's symbol table. Initially, the symbol table con- 
tains the permanent. symbols, but as the source program is assembled, user- 
defined symbols are added to the table. 


3.3.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (see Appendix B.3) 
and assembler directives (see Section 3.8). These symbols are a permanent 
part of the Assembler's symbol table and need not be defined before being 


used in the source program. 


3.3.2 User-Defined Symbols 

‘User-defined symbols are those defined as labels (see Section 3.2.1) or by 
direct assignment (see Section 3.3.3). These symbols are added to the sym- 
bol table as they are encountered during the first pass of the assembly. 
They can be composed of alphanumeric characters, dollar signs, and periods 
only; again, dollar signs and periods are reserved for use by the system 
software. Any other character is illegal and, if used, will result in the 
error message I (see Section 3.11). The following rules also apply to 


user-defined symbols: 
l. The first character must not be a number. 
2. Each symbol must be unique within the first six characters. 


3. A symbol may be written with more than six legal characters 
but the seventh and subsequent characters are only checked 
for legality, and are not otherwise recognized by the Assembler. 


4. Spaces and tabs must not be embedded within a symbol. 


A user-defined symbol may duplicate a permanent symbol. The value as- 
Sociated with a permanent symbol that is also user-defined depends upon its 
use: > 


l. A permanent symbol encountered in the operator field is as- 
sociated with its corresponding machine op-code. 


2. If a permanent symbol in the operand field is also user- 
defined, its user-defined value is associated with the symbol. 
If the symbol is not found to be user-defined, then the cor- 
responding machine op-code value is associated with the symbol. 


3.3.3 Direct Assignment 

A direct assignment statement associates a symbol with a value. When a 
direct assignment statement defines a symbol for the first time, that sym- 
bol is entered into the Assembler's symbol table and the specified value is 
associated with it. A symbol may be redefined by assigning a new value to 


a previouslv defined symbol. The newly assigned value will replace the 
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previous value assigned to the symbol. 
The general format for a direct assignment statement is 
symbol = cilius sion 
The following conventions apply: 
1. An equal sign (=) must separate the symbol from 


the expression defining the symbol. 


2. A direct assignment statement may be preceded by 
a label and may be followed by a comment. 


3. Only one symbol can be defined by any one direct. 
assignment statement. 
4. Only one level of forward referencing is allowed. 


Example of the two levels of forward referencing (illegal): 


X 
X 
Z 


uo wu dg 
HNK 


X and Y are both undefined throughout pass 1 and will be listed on the 
rinter as such at the end of that pass. X is undefined throughout pass 
.2, and will cause a U error message. 


Examples: 
A, = 1 ;THE SYMBOL A IS EQUATED WITH THE VALUE 1 
B = 'A-1&MASKLOW ;THE SYMBOL B IS EQUATED WITH THE EXPRES- 
;SION'S VALUE. 
Cs. Du ¿THE SYMBOL D IS EQUATED WITH 3. THE 
E: MOV #1,ABLE ;LABELS C AND E ARE EQUATED WITH THE 
;NUMERICAL MEMORY ADDRESS OF THE MOV 
;COMMAND. 


3.3.4 Register Symbols 
The eight general registers of the PDP-11 are numbered 0 through 7. These 
isters may be referenced by use of a register symbol, that is, a sym- 


olic name for a register. A register symbol is defined by means of a 


dej 








direct assignment, where the defining expression contains at least one 
term preceded by a $ or at least one term previously defined as a register 


symbol. 
RG=39 ;DEFINE RØ AS REGISTER fg 
R3=RØ+3 ;DEFINE R3 AS REGISTER 3 
R4=1+33 DEFINE R4 AS REGISTER 4 
THERE=%2 ;DEFINE "THERE" AS REGISTER 2 


It is important to note that all register symbols must be defined before 
they are referenced. A forward reference to a register symbol will gener- 
ally cause phase errors (see Section 3.10). 


The $ may be used in any expression thereby indicating a reference to 
a register. Such an expression is a register expression. Thus, the state- 


ment 
CLR $6 

will clear register 6 while the statement 
CLR 6 


will clear the word at memory address 6. In certain cases a register can 
be referenced without the use of a register symbol or register expression. 
These cases are recognized through the context of the statement and are 
thoroughly explained in Sections 3.6 and 3.7. Two obvious examples of this 


are: 


JSR 5,SUBR ; THE FIRST OPERAND FIELD MUST 
;ALWAYS BE A REGISTER. 


CLR X2) ;ANY EXPRESSION ENCLOSED IN 
;( ) MUST BE A REGISTER. IN 
;THIS CASE, INDEX REGISTER 2. 


3.4 EXPRESSIONS 


Arithmetic and logical operators (see Section 3.4.2) may be used to form 
expressions. A term of an expression may be a permanent or user-defined 
symbol, a number, ASCII data, or the present value of the assembly loca- 
tion counter represented by the period. Expressions are evaluated from 


left to right.  Parenthetical grouping is not allowed. 
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Expressions are evaluated as word quantities. The operands of a 
.BYTE directive (Section 3.8.5) are evaluated as word expressions before 


truncation to the low-order eight bits. 


A missing term or expression will be interpreted as 0. A missing 
operator will be interpreted as +. The error code Q (Questionable syntax) 


will be generated for a missing operator. For example, 
“A + -1gg ;OPERAND MISSING 
will be evaluated as A + 0 - 100, and 
TAG ! LA 177777 ;OPERATOR MISSING 
will be evaluated as TAG ! LA+177777. 


3.4.1 Numbers 


the Assembler accepts both octal and decimal numbers. Octal numbers con- 
sist of the digits 0 through 7 only. Decimal numbers consist' of the digits | 
0 through 9 followed by a decimal point. If a number contains an 8 or 9 

and is not followed by a decimal point, the N error code (see Section 3.10) 
will be printed and the number interpreted as decimal. Negative numbers 

may be expressed as a number preceded by a minus sign rather than in a two's 
complement form. Positive numbers may be preceded by a plus sign although 
this is not required. 


If a number is too large to fit into 16 bits, the number is truncated 
from the left. In the assembly listing the statement will be flagged with 


a Truncation (T) error. 


3.4.2 Arithmetic and Logical Operators 


The arithmetic operators are: 

+ indicates addition or a positive number 

x indicates subtraction or a negative number 
The logical operators are defined and illustrated below. 


& indicates the logical AND operation 
! indicates the logical inclusive OR operation 
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3.4.3 ASCII Conversion 


When preceded by an apostrophe, any ASCII character (except null, rubout, 
carriage return, line feed, or form feed) is assigned the 7-bit ASCII value 


of the character (see Appendix A). For example, 
‘A 
is assigned the value 101,. 


When preceded by a quotation mark, two ASCII characters (not includ- 
ing null, rubout, carriage return, line feed, or form feed) are assigned 
the 7-bit ASCII values of each of the characters to be used. Each 7-bit ( 
value is stored in an 8-bit byte and the bytes are combined to form a 
word. For example, "AB will store the ASCII value of A in the low-order 
(even). byte and the value of B in the high-order (odd) byte: 


high-order byte low-order byte 
l 
i 
B's value = 1 0 ! I 0 l = A's value 
(0 i60 001 001 000. 001 
=~ = b wna Se” 
0 4 4 1 0 1 
"AB = 411481 


3.5 ASSEMBLY LOCATION COUNTER 


The period (.) is the symbol for the assembly location counter. (Note dif- 
ference of Program Counter. . # PC.See Section 3.6.) When used in the 
operand field of an instruction, it represents the address of the first 
word of the instruction. When used in the operand field of an assembler 
directive, it represents the address of the current byte or word. For ex- 


ample, 


REFERS TO LOCATION A, I.E., 


A: MOV $.,Rf . 
THE ADDRESS OF THE MOV INSTRUCTION 


. 
r 
. 
, 


# is explained in Section 3.6.9). 


At the beginning of each assembly pass, the Assembler clears the loca- 
tion counter. Normally, consecutive memory locations are assigned to each 
byte of object data generated. However, the location where the object data 
is stored may be changed by a direct assignment altering the location count- 


er. 
.cexpression 


The expression defining the period must not contain forward references 


or symbols that vary from one pass to another. Examples: 





-=599 
FIRST: MOV  .-*10,COUNT ;THE LABEL FIRST HAS THE VALUE 500, 
;.*10 EQUALS 5103: THE CONTENTS 
;OF THE LOCATION 510g WILL BE DE- 
;POSITED IN LOCATION COUNT. 
.752f ;THE ASSEMBLY LOCATION COUNTER NOW 
;HAS A VALUE OF 520g8.. 
SECOND: MOV . , INDEX ;THE LABEL SECOND HAS THE VALUE 520g. 


; THE CONTENTS OF LOCATION 520,, 

;THAT IS, THE BINARY CODE FOR THE 
;INSTRUCTION ITSELF, WILL BE DEPOSITED 
;IN LOCATION INDEX. 


Storage area may be reserved by advancing the location counter. For 
example, if the current value of the location counter is 1000, the direct 


assignment statement 


-=.+199 


will reserve 100, bytes of storage space in the program. The next instruc- 


tion will be stored at 1100. 


3.6 ADDRESSING 


The Program Counter (register 7 of the eight general registers) always con- 
tains the address of the next word to be fetched; i.e., the address of the 


next instruction to be executed, or the second or third word of the current 


instruction. 
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In order to understand how the address modes operate and how they as- 
semble (see Section 3.6.11), the action of the Program Counter must be 
understood. The key rule is: 


Whenever the processor implicitly uses the Program Counter (PC) 
to fetch a word from memory, the Program Counter is automatically 


incremented by two after the fetch. 





That is, when an instruction is fetched, the PC is incremented by two, 
so that it is pointing to the next word in memory; and, if an instruction 
uses indexing (see Sections 3.6.7, 3.6.8, and 3.6.10), the processor uses 
the Program Counter to fetch the base from memory. Hence, using the rule 


above, the PC increments by two, and now points to the next word. 
The following conventions are used in this section: 


a. Let E be any expression as defined in Section 3.4. 


b. Let R be a register expression. This is any expres- 
sion containing a term preceded by a $ character or 
a symbol previously equated to such a term. 


Examples: 
RO = $0 ;GENERAL REGISTER 0 
RL = RO+1 ;GENERAL REGISTER 1 
R2 = 1+ $1 ; GENERAL REGISTER 2 


C. Let ER be a register expression or an expression in 
the range 0 to 7 inclusive. 


d. Let A be a general address specification which pro- 


duces a 6-bit address field as described in the 
PDP-11 Handbook. 


The addressing specification, A, may now be explained in terms of E, 


2, and ER as defined above. Each will be illustrated with the single oper- 


and instruction CLR or double operand instruction MOV. 


3.6.1 Register Mode 


The register contains the operand. 


Format: R 
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Example: 


RO = $0 ;DEFINE RO AS REGISTER 0 
CLR RO ;CLEAR REGISTER 0 


3.6.2 Deferred Register Mode 


The register contains the address of the operand. 





Format: @R or (ER) | 
Exarple: 
CLR @R1 ;CLEAR THE WORD AT THE 
or . ;ADDRESS CONTAINED IN. 
CLR CE) ;REGISTER 1. 


3.6.3 Autoincrement Mode 


The contents of the register are incremented immediately after being used 


t ice 


as the address of the operand. 
Format: —. (ÉR)* 


Examples: 


CLR (RO)+ ¿CLEAR WORDS AT ADDRESSES 
CLR (RO+3)+ ; CONTAINED IN REGISTERS 0, 3, AND 2 AND. 
CLR (2)+ ; INCREMENT REGISTER CONTENTS 

;BY TWO. 


Y 
a. Both JMP and JSR instructions using mode 2 (non-deferred Autoincre- 
ment Moce) autoincrement the register before its use. 


b. In double operand instructions of the addressing form $R,(R)+ or 
$R,-(R) where the source and destination registers are the same, the 
source cperand is evaluated as the autoincremented or autodecremented 
value; but the destination register, at the time it is used, still con- 
tains the originally intended effective address. 


For example, if Register 0 contains 100, the following occurs: 


MOV RØ, (Ø)+ ;THE QUANTITY 102 IS MOVED TO LOCATION 100 
MOV RØ,-() ;THE QUANTITY 76 IS MOVED TO LOCATION 76 


The use of these forms should be avoided, as they are not guaranteed 
to remain in future PDP-1l's. 











3.6.4 Deferred Autoincrement Mode 


The register contains the pointer to the address of the operand. The con- 


tents of the register are incremented after being used. 
Format: @(ER)+ 


Example: 


CLR @(3)+ ;CONTENTS OF REGISTER 3 POINT 
;TO ADDRESS OF WORD TO BE CLEARED 
;BEFORE BEING INCREMENTED BY TWO 


3.6.5 Autodecrement Mode 


The contents of the register are decremented before being used as the ad- 


3 ' e] 1 
dress of the operand. 


Format: - (ER) 
Examples: 
CLR - (RO) ;DECREMENT CONTENTS OF REG- 
CLR -(R043) ;ISTERS 0, 3, AND 2 BEFORE USING 
CLR -(2) ;AS ADDRESSES OF WORDS TO BE CLEARED 


3.6.6 Deferred Autodecrement Mode 


The contents of the register are decremented before being used as the 


pointer to the address of the operand. 


Format: Q- (ER) 





d; i 
See previous footnote. 
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Example: 


CLR @-(2) ;DECREMENT CONTENTS OF REG. 2 
;BEFORE USING AS POINTER TO ADDRESS 
;OF WORD TO BE CLEARED 


3.6.7 Index Mode 


Format: E (ER) 


The value of an expression E is stored as the second or third word of the 
instruction. The effective address is calculated as the value of E plus 


the contents of register ER. The value E is called the base. 


Examples: 


CLR X+2(R1) ;EFFECTIVE ADDRESS IS X+2 PLUS 
; THE CONTENTS OF REGISTER 1 


CLR. -2(3) ;EFFECTIVE ADDRESS IS -2 PLUS 
;THE CONTENTS OF REGISTER 3 


e e 


3.6.8 Deferred Index Mode 


An expression plus the contents of a register gives the pointer to the ad- 


dress of the operand. 


Format: QE (ER) 
Example: 
CLR @14 (4) ;IF REGISTER 4 HOLDS 100, AND LOCA- 
;TION 114 HOLDS 2000, LOC. 2000 IS 
; CLEARED 


3.6.9 Immediate Mode and Deferred Immediate (Absolute) Mode 
The immediate mode allows the operand itself to be stored as the second or 
third word of the instruction. It is assembled as an autoincrement of 


register 7, the PC. 


Format: $E 
Examples: l 

MOV #100, RO ;MOVE AN OCTAL 100 TO REGISTER 0 
j MOV #X, RO ;MOVE THE VALUE OF SYMBOL X TO 


¿REGISTER 0 





d 3-15 


— ————————————————— 





‘The operation of this mode is explained as follows: 
The statement MOV #100,R3 assembles as two words. These are: 


912793 
ggigg 


Just before this instruction is fetched and executed, the PC points 
to the first word of the instruction. The processor fetches the first 
word and increments the PC by two. The source operand mode is 27 (auto- 
increment the PC). Thus, the PC is used as a pointer to fetch the oper- 
and (the second word of the instruction) before being incremented by two, 
to point to the next instruction. 


If the #E is preceded by @, E specifies an absolute address. 


3.6.10 Relative and Deferred Relative Modes 


Relative Mode is the normal mode for memory references. 


Format: E 
Examples: 
CLR 100 ;CLEAR LOCATION 100 
MOV X,Y ;MOVE CONTENTS OF LOCATION X TO 


;LOCATION Y 


This mode is assembled as Index Mode, using 7, the PC, as the register. 

The base of the address calculation, which is stored in the second or third 
.word of the instruction, is not the address of the operand. Rather, it is 
the number which, when added to the PC, becomes the address of the operand. 
‘Thus, the base is X - PC. The operation is explained as follows. 


If the statement MOV 100,R3 is assembled at location 20, then the as- 


sembled code is: 


Location 20: g167g3 
ggggs5sa 


Location 22: 


The processor fetches the MOV instruction and adds two to the PC so that 
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it points to location 22. 
by the PC. To pick up the base, the processor fetches the word pointed to 
by the PC and adds two to the PC. The PC now points to location 24. To 
calculate the address of the source operand, the base is added to the desig- 
nated register. That is, Base + PC = 54 + 24 = 100, the operand address. 


The source operand mode is 67; that is, indexed 


Since the Assembler considers as the address of the first word of the 


instruction, an equivalent statement would be 
MOV 100 --:- 4(PC),R3 


This mode ts called relative because the operand address is calculated rela- 
tive to the current PC. The base is the distance (in bytes) between the 
operand and the current PC. If the operator and its operand are moved in 

memory so that the distance between the operator and data remains constant, 


the instruction will operate correctly. 


If E is preceded by @, the expression's value is the pointer to the 
address of the operand. | 


-= wp 


3.6.11 Table of Mode Forms and Codes (6-bit (A) format only - see sec- 
tion 3.7 : 


Each instruction takes at least one word. Operands of the first six forms 


listed below do not increase the length of an instruction. Each operand 
in one of the other forms however, increases the instruction length 


by one word. 





Form Mode Meaning 

R fn Register 
None of these D @R or (ER) In Register n deferred 
forms increase (ER) + 2n Autoincrement 
the instruction @(ER)+ 3n Autoincrement deferred 
length. - (ER) 4n Autodecrement 

@- (ER) 5n Autodecrement deferred 

E (ER) 6n Index 
Any of these @E (ER) 7n Index deferred 
forms adds a *E 2, Immediate 
word to the @#E 37 Absolute memory 
instruction reference _ 
length E 6 v Relative 

QE 77 Relative deferred 

reference 
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Bn dM CL e m i t LALO OGG LLL EL ALLE ILA ALATA OEE 


UEM LLL a 
Notes: l 


1. An alternate form for GR is (ER). However, the form @(ER) 
is equivalent to @0(ER). 


2. The form @#E differs from the form E in that the second or 
third word of the instruction contains the absolute address 
of the operand rather than the relative distance between the 
operand and the PC. Thus, the statement CLR @#100 will 
clear location 100 even if the instruction is moved from 
the point at which it was assembled. 


3.7 INSTRUCTION FORMS 


The instruction mnemonics are given in Appendix B. This section defines 
the number and nature of the operand fields for these instructions. 


In the table that follows, let R, E, and ER represent expressions as 


defined in Section 3.4, and let A be a 6-bit address specification of the li 
forms: 

E eg 

R eR or (R) 

(ER) + @ (ER) + 

- (ER) €- (ER) - "EN 

E(ER) @E (ER) 

#E esE 

Table 3-1. Instruction Operand Fields 
Instruction Form Example 
Double Operand Op A,A MOV (R6)+,@Y 
Lingle Operand Op A CLR -—(R2) 
poezate Op HALT 
poem Op E BR X+2 
BLO .-4 
a «(g-.— « 
where 128,95(E 2)/2212749 

‘ubroutine Call JSR ER,A JSR: PC,SUBR 
Subroutine Return RTS ER RIS PC 
PMT/TRAP OP or EMT 
| Op E EMT 31 
| where 0SE5377, 
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The branch instructions are one word instructions. The high byte con- 
tains the op code and the low byte contains an 8-bit signed offset (7 bits 
plus sign) which specifies the branch address relative to the PC. The 


hardware calculates the branch address as follows: 


a) Extend the sign of the offset through bits 8-15. 


b) Multiply the result by 2. This creates a word offset 
rather than a byte offset. 


c) Add the result to the PC to form the final branch ad- 
dress. 


The Assembler performs the reverse operation to form the byte offset 
from the specified address. Remember that when the offset is added to the 
PC, the PC is pointing to the word following the branch instruction; hence 
the factor -2 in the calculation. l 


Byte offset = (E-PC)/2 truncated to eight bits. 
Since PC = .+2, we have 
Byte offset = (E---2)/2 truncated to eight bits. 


The EMT and TRAP instructions do not use the low-order byte of the 
word. This allows information to be transferred to the trap handlers in 
the low-order byte. If EMT or TRAP is followed by an expression, the value 
is put into the low-order byte of the word. However, if the expression is 
too big (23779) it is truncated to eight bits and a Truncation (T) error 


occurs. 


3.8 ASSEMBLER DIRECTIVES 


Assembler directives (sometimes called pseudo-ops) direct the assembly 
process and may generate data. They may be preceded by a label and 
followed by a comment. The assembler directive occupies the operator 
field. Only one directive may be placed in any one statement. One or 
more operands may occupy the operand field or it may be void -- allow- 


able operands vary from directive to directive. 
349.1. .EOT 


The .EOT directive indicates the physical End-Of-Tape though not the logical 


end of the program. If the .EOT is followed by a single line feed or 
form feed, the Assembler will still read to the end of the tape, but 
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.be ignored. 





will not process anything past the .EOT directive. If .EOT is followed 
by at least two line feeds or form feeds, the Assembler will stop before 
the end of the tape. Either case is proper, but it should be understood 
that even though it appears as if the Assembler has read too far, it 
actually hasn't. 


If a .EOT is embedded in a tape, and more information to be as- 
sembled follows it, .EOT must be immediately followed by at least two 
line feeds or form feeds. Otherwise, the first line following the .EOT 
will be lost. 


Any operands following a .EOT directive will be ignored. The .EOT 
directive allows several physically separate tapes to be assembled as one 
program. The last tape is normally terminated by a .END directive (see 
Section 3.8.3) but may be terminated with -EOT (see .END emulation in 
Section 3.9.4). l 


3.8.2  .EVEN 


The .EVEN directive ensures that the assembly location counter is even by 
adding one if it is odd. Any operands following a .EVEN directive will 


— v 


Bs Bis » END 


The .END directive indicates the logical and physical end of the source 


“program. The .END directive may be followed by only one operand, an ex- 


pression indicating the program's entry point. 


At load time, the object tape will be loaded and program execution will 
begin at the entry point indicated by the .END directive. If the entry 
point is not specified, the Loader will halt after reading in the object 


tape. 


3.8.4 „WORD 


The .WORD assembler directive may have one or more operands, separated by 
commas. Each operand is stored in a word of the object program. If there 
is more than one operand, they are stored in successive words. The oper- 


ands may be any legally formed expressions. For example, 


.=1429 

SAL-f 

.WORD 177535,.+4,SAL ;STORED IN WORDS 1429, 1422, AND 
:1424 WILL BE 177535, 1426, AND f. 
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Values exceeding 16 bits will be truncated from the left, to word 
length. 


A .WORD directive followed by one or more void operands separated by 
commas will store zeros for the void operands. For example, 


-=1439 7;ZERO, FIVE, AND ZERO ARE STORED 
.WORD ,5, ;IN WORDS 1439, 1432, AND 1434. 


An operator field left blank will be interpreted as the .WORD direc- 
tive if the operand field contains one or more expressions. The first 
term of the first expression in the operand field must not be an instruc- 
tion or assembler directive unless preceded by a +, -, or one of the logi- 
cal operators ! or &. For example, 


i 


.-44f ;THE OP-CODE FOR MOV, WHICH IS f1g9gg, 
LABEL: +MOV,LABEL ;IS STORED IN LOCATION 449. 449 IS 
;STORED IN LOCATION 442. 


Note that the default .WORD will occur whenever there is a leading 
arithmetic or logical operator, or whenever a leading symbol is encountered 
which is not recognized as an instruction mnemonic or assembler directive. 
Therefore, if an instruction mnemonic or assembler directive is misspelled, 
the .WORD directive is assumed and errors will result. Assume that MOV is. 
spelled incorrectly as MOR: 


MOR A,B 


Two error codes can result: a Q will occur because an expression operator 
is missing between MOR and A, and a U will occur if MOR is undefined. Two 
words will be generated; one for MOR A and one for B. 


3.8.5: "BYTE 


The .BYTE assembler directive may have one or more operands separated by 
commas. Each operand is stored in a byte of the object program. If multiple 
operands are specified, they are stored in successive bytes. The operands 
may be any legally formed expression with a result of 8 bits or less. For 
example, l 


SAM=5 ;STORED IN LOCATION 419 WILL BE 
-=419 ;969 (THE OCTAL EQUIVALENT OF 48). 
: .BYTE 48.,SAM ;IN 411 WILL BE $95. 
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If the expression has a result of more than 8 bits, it will be trun- uj 
cated to its low-order 8 bits and will be flagged as a T error. If an 
operand after the .BYTE directive is left void, it will be interpreted as 


zero. For example, 


-=429 7ZERO WILL BE STORED IN 
.BYTE , , ;BYTES 429, 421 AND 422. 


3.8.6. „ASCII 


The .ASCII directive translates strings of ASCII characters into their 7- 
bit ASCII codes«with the exception of null, rubout, carriage return, line 
feed,.and form feed. The text to be translated is delimited by a charac- 
ter at the beginning and the end of the text. The delimiting character may 
be any printing ASCII character except colon and equal sign and those used 
in the text string. The 7-bit ASCII code generated for each character will 


be stored in successive bytes of the object program. For example, 


.=590 ;THE ASCII CODE FOR "Y" WILL BE 
.ASCII /YES/ ;STORED IN 59%, THE CODE FOR "E" 
;IN 591, THE CODE FOR "S" IN 592. 


.ASCII /5+3/2/ ;THE DELIMITING CHARACTER OCCURS- ~ 
;AMONG THE OPERANDS. THE ASCII ! 
;CODES FOR "5", "+", AND "3" ARE | 
;STORED IN BYTES 543, 594, AND 
7595. 2/ IS NOT ASSEMBLED. 


The .ASCII directive must be terminated by a space or a tab. 
3.9 OPERATING PROCEDURES 


3.9.1 Introduction 


The Assembler enables you to assemble an ASCII tape containing PAL-11A 

statements into an absolute binary tape. To do this, two or three 

passes are necessary. On the first pass the Assembler creates a table 

of user-defined symbols and their associated values, and a list of 
undefined symbols is printed on the teleprinter. On the second pass the 
Assembler assembles the program and punches out an absolute binary tape 
and/or outputs an assembly listing. During the third pass (this pass is 
optional) the Assembler punches an absolute binary tape or outputs an 
assembly listing. The symbol table (and/or a list of errors) may be out- 
put on any of these passes. The input and output devices as well as 
various options are specified during the initial dialogue (see Section 3.9.3). 
The Assembier initiates the dialogue immediately after being loaded and 
after the last pass of an assembly. 
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See Loading PAL-11A 


PAL-l11A is loaded by the Absolute Loader (see Chapter 6 for operating | 
procedures). Note that the start address of the Absolute Loader must be 
in the Switch Register when loading the Assembler. This is because the ` 

Assembler tape' has an initial portion which clears all of core up to the 
J address Specified in the Switch Register, and jumps to that address to 
start loading the Assembler. 


3.9.3 Initial Dialogue 


After being loaded, the Assembler initiates dialogue by printing on the 
teleprinter: 





*S 


meaning "What is the Source symbolic input device?" The response may 
be: 


H meaning High-speed reader 
L meaning Low-speed reader 
T meaning Teletype keyboard =o 


If the response is T, the source program must be typed at the terminal 
once for each pass of the assembly and it must be identical each time it 
is typed. 


The device specification is terminated, as is all user response, by typ- 
ing the RETURN key. 

If an error is made in typing at any time, typing the RUBOUT key will 
erase the immediately preceding character if it is on the current line. 


Typing CTRL/U will erase the whole line on which it occurs. 


After the *S question and response, the Assembler prints: 


*B 





Si 


meaning "what is the Binary output device?" The responses to *B are simi- 
S y 


H meaning High-speed punch 
L meaning Low-speed punch 


meaning do not output binary tape 
P) (3 denotes typing the RETURN key) 


In addition to I/O device specification, various options may be chosen. 
The binary output will occur on the second pass unless /3 (indicating the 
third pass) is typed following the H or L. Errors will be listed on the 
same pass if /E is typed. If /E is typed in response to more than one in- 
guiry, only the last occurrence will be honored. It is strongly suggested 
that the errors be listed on the same pass as the binary output, since: 
errors may vary from pass to pass. If both /3 and /E are typed, /3 must 


precede /E. The response is terminated by typing the RETURN key. Examples: 


T3. L/5- Binary output on the low-speed punch and 

the errors on the teleprinter, both during 

the second pass. 

*8 H/3/E Binary output on the high-speed punch and "^ 
the errors on the teleprinter, both during mA 
the third pass. l 


*3 9 Typing just the RETURN key TX the Assembler 
to omit binary output. 


After the *B question and response, the Assembler prints: 


*1 


meaning "What is the assembly Listing output device?" The response to *L 
may be: 


meaning Low-speed punch (outputs a tab as a tab-rubout) 
meaning High-speed punch 

meaning Teleprinter (outputs a tab as multiple Spaces) 
meaning line Printer (8K version only) 





we U Ho m tr 


meaning do not output listing 
(2 denotes typing the RETURN key) 


After the I/O device specification, pass and error list options simi- 
lar to those for *B may be chosen. The assembly listing will be output on 
third pass unless /2 (indicating the second pass) is typed following 
, hi, T, or P. Errors will be listed on the teleprinter during the same 
pass if /E is typed. If both /2 and /E are typed, /2 must precede /E. 

The response is terminated by typing the RETURN key. Examples: 


*t L/2/E x Listing on low-speed punch and errors 
on teleprinter during second pass. 


*L H Listing on iu specu punch during 
: third pass. 


*I The RETURN key alone will cause the 
Assembler to omit listing output. 


After the *L question and response, the final question is printed on 
the teleprinter: 


TI 


meaning "What is the symbol Table output device?" The device specification 
is the same as for the *L question. The symbol table will be output at 

the end of the first pass unless /2 or /3 is typed in response to *T. The 
ne tape to be assembled should be placed in the reader before typing 


the RETURN key because assembly will begin upon typing the RETURN key in 


response to the *T question. The /E option is not a meaningful response 


to *T. Example: 


"D fs Symbol table output on teleprinter at 
end of third pass. 


* 
i 
& 


Typing just the RETURN key will cause the 
Assembler to omit symbol table output. 


The symbol table is printed alphabetically, four symbols per line. 
"Each symbol printed is followed by its identifying characters and by its 
value. If the symbol is undefined, six asterisks replace its value. The 
identifying characters indicate the class of the symbol; that is, whether 
it is a label, direct-assignment, register symbol, etc. The following 

es show the various forms: 
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ABCDEF 001244 (Defined label) 


R3 = %000003 (Register symbol) 

DIRASM = 177777 (Direct assignment) 

XYZ = LERLES (Undefined direct assignment) 
R6 = BARKERS (Undefined register symbol) 
LABEL = kek RRR (Undefined label) 


Generally, undefined symbols (including labels) will be listed 


as undefined direct assignments. 


Multiply-defined symbols are not flagged in the symbol table printout 


but they are flagged wherever they are used in the program. 


It is possible to output both the binary tape and the assembly list- 
ing on the same pass, thereby reducing the assembly process to two passes 
(see Example 1 below). This will happen automatically unless the binary 
device and the listing device are conflicting devices or the same device 
(see Example 2 below). The only conflicting devices are the teleprinter 
and the low-speed punch. Even though the Assembler deduces that three 
passes are necessary, the binary and listing can be forced on pass 2 by 
including /2 in the responses to *B and *L (see Example 3 below). 


Example 1. Runs 2 passes: 


*5. H High-speed reader 
*B-H High-speed punch 
*"L.P Line Printer 
ITOX Teleprinter 


Example 2. Runs 3 passes: 


*S -H High-speed reader 
*B B High-speed punch 
*L H High-speed punch 
-r 3 Teleprinter 


Example 3. Runs 2 passes: 


*S H High-speed reader 

*B- H/2 High-speed punch on pass 2 
*L H/2 High-speed punch on pass 2 
wa. T Teleprinter 


Note that there are several cases where the binary output can be 
intermixed with ASCII output: l 


a. *B H/2 Binary and 
*L H/2 listing to punch on pass 2 
b. *B L/E Binary to low-speed punch and 


error listing to teleprinter 
(and low-speed punch) 


c. *B  L/2/E Binary, error listing, and ees: 
*L T/2 l listing to low-speed punch. 





The binary so generated is loadable by the Absolute Loader as long as there 
are no CTRL/A characters in the source program. The start of every block 
on the binary tape is indicated by a 001 and the Absolute Loader ignores 
all information until a 001 is detected. Thus, all source and/or error 
messages will be ignored if they do not contain any CTRL/A characters 
(octal 001). 


If a character other than those mentioned is typed in response to 


a question, the Assembler will ignore it and print the question again. 


Example: 
*S H High-speed reader 
"Bg Q is not a valid response 
*B The question is repeated 


If at any time you wish to restart the Assembler, type CTRL/P. 


when no passes are omitted or error options specified, the Assembler 


performs as follows: 








PASS 1: 


PASS 2: 


PASS 3: 


Assembler creates a table of user-defined symbols and 

their associated values to be used in assembling the source d 
to object program. Undefined symbols are listed on the tele- 

printer at the end of the pass. The symbol table is also 

listed at this time. If an illegal location statement of the 

form .-expression is encountered, the line and error code will 

be printed out on the teleprinter before the assembly proceeds. 

An error in a location statement is usually a fatal error in 

the program and should be corrected. 


Assembler punches the object tape, and prints the pass error 
count and undefined location statements on the teleprinter. 


Assembler prints or punches the assembly program listing, un- 
defined location statements, and the pass error count on the 
teleprinter. ! 


The functions of passes 2 and 3 will occur simultaneously on pàss 2 if the 


binary and listing devices are different, and do not conflict with each 


other (low-speed punch and Teletype printer conflict). 


The following table summarizes the initial dialogue questions: 


Printout 


-a5 
*B 
vi 

*T 


— p 


Inquiry 


What is the input device of the Source symbolic tape? 
What is the output device of the Binary object tape? 
What is the output device of the assembly Listing? 
What is the output device of the symbol Table? 


The following table summarizes the legal responses: 


‘Character 


Response Indicated 


Teletype keyboard or printer 

Low-speed reader or punch 

High-speed reader or punch 

Line Printer (8K version only) 

Pass l 

Pass 2 

Pass 3: 

Errors listed on same pass (not meaningful in response to *S or *T) 


Omit function 


Typical examples of complete initial dialogues: 


For minimal PDP-11 configuration: 


*S L Source input on low-speed reader 
*B L/B. Binary output on low-speed punch 
Errors during same (second) pass 
*h T Listing on teleprinter during pass 3 
*T JT Symbol table on teleprinter at end of pass 1 


For a PDP-11 with high-speed I/O devices: 


*S H | Source input on high-speed reader 
*B H/E Binary output on high-speed punch, 

Errors during same (second) pass. 
ad No listing 


*T 7/2 Symbol table on teleprinter at end of pass 2 


3.9.4 Assembly Dialogue rie 

During assembly, the. Assembler will pause to print on the teleprinter vari- 
ous messages to indicate that you must respond in some way before the as- 
sembly process can continue. You may also type ÇTRL/P, at any time, if you 


‘wish to stop the assembly process and restart the initial dialogue, as men- 


tioned in the previous section. 


When a .EOT assembler directive is read on the tape, the assembler 
prints: 


EOP ? 


and pauses. During this pause, the next tape is placed in the reader, and 
RETURN is typed to continue the assembly. 


If the specified assembly listing output device is the high-speed 
punch and if it is out of tape, or if the device is the Line Printer and 
is out of paper, the Assembler prints on the teleprinter: 


EOM ? 





- : j———————————— 


and waits for tape or paper to be placed in the device. Type the RETURN 
key when the tape or paper has been replenished; assembly will continue. 


Pino 


Conditions causing the EOM ? message for an assembly listing device 


are: 


HSP LPT 

No power No power 

No tape Printer drum gate open L 
Too hot 
No paper 


There is no EOM if the line printer is switched off-line, although charac-. 
ters may be lost for this condition as well as for an EOM. If the binary 
output device is the high-speed punch and if it is out of tape, the 
Assembler prints: 





EOM ? 
*S e 
The assembly process is aborted and the initial dialogue is begun again. i 


When a .END assembler directive is read on the tape, the Assembler 
prints: 


END ? 


and pauses. During the pause the first tape is placed in the reader, and 
the RETURN key is typed to begin the next pass. On the last pass, the 
.END directive causes the Assembler to begin the initial dialogue for the 
next assembly. 


If you are starting the binary pass and the binary is to be punched 
on the low-speed punch, turn the punch on before typing the RETURN key. 
for starting the pass. The carriage return and line feed characters will 
be punched onto the binary tape, but the Absolute Loader will ignore them. 


If the last tape ends with a .EOT, the Assembler may be told to 
emulate a  .END assembler directive by responding with E followed by the. 
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RETURN key. The Assembler will then print: 
END ? 


and wait for another RETURN before starting the next pass. Example: 








NOTE 


When a .END directive is emulated with an E 
response to the EOF? message, the error 
counter is incremented. 


To avoid incrementing the error counter, 
place a paper tape containing only the line 
.END in the reader and press the RETURN key 
instead of using the E response. 


3.9.5 Assembly Listing m 


PAL-11A produces a side-by-side assembly listing of symbolic source state- 
ments, their octal equivalents, assigned absolute addresses, and error 


codes, as follows: 


EELLLLLL 000000 SSS...... S 
000000 
000000 


The E's represent the error field. The L's represent the absolute address. 
The O's represent the object data in octal. The S's represent the source 
statement. While the Assembler accepts 7219 characters per line on input, 
the listing is reduced by the 16 characters to the left of the source state- 


ment. 


The above represents a three-word statement. The second and third 
words of the statement are listed under the command word. No addresses pre- 


cede the second and third words since the address order is sequential. 


The third line is omitted for a two-word statement; both second and > 


third lines are omitted for a one-word statement. 


a 
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E 


For a 


.BYTE directive, the object data field is three octal digits. 


For a direct assignment statement, the value of the defining expression 
-is given in the object code field although it is not actually part of the í 


code of the object program. 


Each page of the listing is headed by a page number. 


3.40 


ERROR CODES 


The error codes printed beside the octal and symbolic code in the assembly 


listing have the following meanings: 
i $ a 


Error Code 


A 





Meaning 


\ 
Addressing error. An address within the instruction 
is incorrect. 


Bounding error. Instructions or word data are being 
assembled at an odd address in memory. The location 
counter is updated by +l. 


Doubly-defined symbol referenced. Reference was made 
to a symbol which is defined more than once. . > 


Illegal character detected. Illegal characters which 
are also non-printing are replaced by a ? on the list- 
ing. 


Line buffer overflow. Extra characters on a line (more 
than 724 o? are ignored. 


Multiple definition of a label. A label was. encoun- 
tered which was equivalent (in the first six charac- 
ters) to a previously encountered label. 


Number containing 8 or 9 has no decimal point. 


Phase error. A label's definition or value varies 
from one pass to another. 


Questionable syntax. There are missing arguments or 
the instruction scan was not completed or a carriage 
return was not immediately followed by a line feed or 
form feed. 


Register-type error. An invalid use of or reference 
to a register has been made. 


Symbol table overflow. When the quantity of user- 

defined synbois exceeds the allocated space available í 
in the user's symbol table, the assembler outputs the . 

cürrent source line with the S error code, then returns 

to the initial dialogue. 
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Truncation error. A number generated more than 16 

bits of significance or an expression generated more 
than 8 bits of significance during the use of the .BYTE 
directive. 


Undefined symbol. An undefined symbol was encountered 
during the evaluation of an expression. Relative to 
the expression, the undefined symbol is assigned a 
value of zero. 


3.11 SOFTWARE ERROR HALTS 


PAL-112% loads all unused trap vectors with the code 


.WORD .+2,HALT 


so that if the trap does occur, the processor will halt in the second word 


of the vector. The address of the halt, displayed in the console address 


register, therefore indicates the cause of the halt. In addition to the 


halts wnich may occur in the vectors, the standard IOX error halt at loca- 


tion 40 may occur (see Chapter 7). 


Address of Halt Meaning 
i2 Reserved instruction executed 
16 Trace trap occurred 
26 Power fail trap 
32 EMT executed 
40 IOX detected error 


See Appendix B for summaries of PAL-11A features. 
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CHAPTER 4 


Editing the Source Program, ED-11 


The PDP-11 Text Editor program (ED-11) enables you to display your source 
program (or any text) on the teleprinter, make corrections or additions 
zo it, and punch all or any portion of the program on paper tape. This 
is accomplished by typing simple one-character commands on the keyboard. 


The Editor commands can be grouped according to function: 


input/output; 

searching for strings of characters; 

positioning the current character location pointer; 
4. inserting, deleting, and exchanging text portions. 


All input/output functions are handled by IOX, the PDP-11 Input/Output 
Executive (see Chapter 7). 


4.1 COMMAND MODE AND TEXT MODE 


whenever ED-11 prints an * on the teleprinter, you may type a command 
to it. (Only one command per line is acceptable.) The Editor is then 
said to be in Command Mode. While most commands operate exclusively in 
this mode, there are five ED-11 commands that require additional infor- 
mation in order for the commands to be carried out. The Editor goes 


into Text Mode to receive this test. 


Should a nonexistent command be typed or a command appear in incorrect 
format, ED-ll will print a ?. This will be followed by an * at the besin- 
ning of a new line indicating that the Editor is in Command Mode. 


Editor processing begins in Command Mode. When you type a command, 
no action occurs until you follow it by typing the RETURN key (sometimes 
symbolized as Por If the command is not a text-type command, typing the 
RETURN key will initiate the execution of the command and ED-11 will 
remain in Command Mode. However, if the command is a text-type command 
(Insert, eXchange, Change, Get, or wHole), typing the RETURN key will 
cause the Editor to go into Text Mode. At this time you should type 


« 


4-1 








Án 


the text to be operated on by the command. This can include the non- 
printing characters discussed below, as well as spaces and tabs (up to 


eight spaces generated by the CTRL/TAB keys). 


Note that typing the RETURN key always causes the physical return 
of the Teletype ball to the beginning of the line, and automatically 
generates a line feed thereby advancing the carriage to a new line. 

In Text Mode, the RETURN key not only serves these mechanical functions, 

allowing you to continue typing at the beginning of a new,line, but at. 

the same time it enters a carriage return and line feed character into 

the text. (A carriage return not followed by a line feed cannot, 
therefore, be entered from the keyboard.) . 


These are both counted as characters and can be edited along 
with the printing characters (as can the form feed, discussed in 
Section 4.2.5). When you wish to terminate Text Mode and reenter 
Command Mode, you must type the LINE FEED key (sometimes symbolized 
as + ). A typed LINE FEED is not considered to be part of the text 
unless it is the first character entered in Text Mode. 


4.2 COMMAND DELIMITERS 


6.2.1 Arguments 

Some ED-ll commands require an argument to specify the particular portion 
of text to be affected by the command or how many times to perform the com- 
mand. In other commands this specification is implicit and arguments are 


not allowed. 
The ED-ll command arguments are described as follows: 


l. n stands for any number from 1 to 32767 0 (255.33 and may, 
except where noted, be preceded by a + à? i 

If no sign precedes n, it is assumed to be a positive 

number. 


Where an argument is acceptable, its absence implies 
an argument of 1 (or -1 if.a —- is present). 


The role of n varies according to the command it is 
associated with. 


2. 0 refers to the beginning of the current line. 


3. @ refers to a marked (designated) character Location 
(see Section 4.2.3). 


4, / refers to the end of text in the Page Buffer. 


The roles of all arguments will be explained further with the cor- 
responding commands which qualify them. 


4.2.2 The Character Location Pointer (Dot) 


Almost all ED-11 commands function with respect to a movable reference 
point, Dot. This character pointer is normally located between the most 
recent character operated upon and the next character; and, at any given 
time, can be thought of as "where the Editor is" in your text. As will 
be seen shortly, there are commands which move Dot anywhere in the text, 
thereby redefining the "current location" and allowing greater facility 
in the use of the other commands. 


4.2.3 Mark 


In addition to Dot, a secondary character pointer known as Mark also exists 
in ED-ll. This less agile pointer is used with great effect to mark or 
"remember" a location by moving to Dot and conditionally remaining there 
while Dot moves on to some other place in the text. Thus, it is possible 
to think of Dot as "here" and Mark as "there". Positioning of Mark, which 
is referenced by means of the argument @, is discussed below in several 
commands. 


4.2.4 Line-Oriented Command Properties 


ED-11 recognizes a line as a unit by detecting a line-terminator in the 
text. This means that ends of lines (line feed or form feed characters) 
are counted in line-oriented commands. This is important to know, parti- 
cularly if Dot, which is a character location pointer, is not pointing at 


the first character of a line. 


"In such a case, an argument n will not affect the same number of 
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lines (forward) as its negative (backward). For example, the argument -1 
applies to the character string beginning with the first character following 


the 


[01 


econd previous end-of-line character and ending at Dot; argument +1 ap- 
| plies to the character string beginning at Dot and ending at the first end- 
of-line character. If Dot is located, say, in the center of a line, notice 


that zhis would affect 1-1/2 lines back or 1/2 line forward, respectively: 


Example of List Commands -1L and +lL: 


Text Command Printout 
CMPBY ICHAR, #933 *-1L BEQ SALT 
BEQ SALT CMPB I l 
CMPB HAR, #175 *+1L rA Ó ; 
BNE e "PLACE CHAR.2175 Vit we 8 


\ t here 
Dot is here t 


| 4.2.5 The Page Buffer 

The Page Buffer holds the text being edited. The unit of source data that . u 
is read into the Page Buffer from a paper tape, is the page. Normally, a 
page is terminated, and therefore defined by a form feed (CTRL/FORM) in the 
source text wherever a page is desired. (A form feed is an acceptable Text. 
Mode character.) Overflow, no-tape, or reader-off conditions can also end 
a page of input (as described in Section 4.3.1.2). Since more than one © 
page of text can be in the buffer at the same time, it should be noted that 
-the entire contents of the Page Buffer are available for editing. 


4.3 COMMANDS 


4.3.1 Input and Output Commands 


Three commands are available for reading in a page of text. The Read com- 
mand (Section 4.3.1.2) is a specialized input command; the Next command : 
(Section 4.3.1.4) reads in a page after punching out the previous page; 
and the wHole command (Section 4.3.3.2) reads in and punches out pages 

of text as part of a search for a specified character string. 


Output commands either list text or punch it on paper tape. The List 
command causes specified lines of text to be output on the teleprinter so 
that they may be examined. Paper tape commands (Next and wHole also per- 
form input ) provide for the output of specified pages, lines, form feeds 
(for changing the amount of data that constitutes a given page), and blank i 
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tape. Note that the process of outputting text does not cause Dot to 
move. 


4.3.1.1 Open 


The Open command (0) should be typed whenever a new tape is put in the 
reader. This is used when the text file being edited is on more than 
one paper tape. 


Note also, that if the reader is off at the time an input command is 


given, turning the reader on must be followed by the Opén command. 


4.3.1.2 Read 


One way of getting a page of text into the Page Buffer so that it can be 
edited is by means of the Read (R) command. The command R causes a page of 
text to be read from either the low-speed reader or high-speed reader (as 
specified in the starting dialogue, Section 4.4.2), and appended to the 
contents (if any) of the Page Buffer. ~ 


Text will be read in until either: 


l. A form feed character is encountered; 


2. The page buffer is 128 characters from being 
filled, or a line feed is encountered after the 
buffer has become 500 characters from being filled; 


3. The reader is turned off, or runs out of paper tape 
(see Open command, Section 4.3.1.1). 


Following execution of an R command, Dot and Mark will. be located at 
the beginning of the Page Buffer. 


A. 4K system can accommodate about 4000 characters of text. Each addi- 


tional 4K of memory will provide space for about 8000 characters. 


NOTE 


An attempt to overflow the storage area will 
cause the command (in this case, R) to stop 
executing. A ? will then be printed, followed . 
by an * on the next line indicating that a com- 
mand may be typed. No data will be lost. l 
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4.3.1.3 List and Punch i 


Output commands List (L) and Punch (P) can be described together, as they 
differ only in that the device addressed by the former is the teleprinter, 
and the device addressed by the latter is the paper tape punch. Dot is 


not moved by these commands. 


nL . Lists | the character string beginning at Dot and 

nP Punches ending with the nth end-of-line 

-nL Lists the character string beginning with the 

-nP Punches first character following the {n+l)th pre- 
vious end-of-line and terminating at Dot 

OL Lists 1 the character string beginning with the 

OP Punches j first character of the current line and 
ending at Dot 

@L Lists the character string between Dot and the 

| ep Punches | Marked location 

/L Lists the character string beginning at Dot and 

/? Punches ending with the last character in the Page 
Buffer 


-—m 


In addition to the above List commands, there are three special List com- 
mands that accept no arguments. The current line is defined as the line i 
containing Dot, i.e., from the line feed (or form feed) preceding Dot to 

the line feed (or form feed) following Dot. 


V Lists the entire line containing Dot 


< Same as -lL. If Dot is located at the 
beginning of a line, this simply lísts 
the line preceding the current line 






> Lists the line following the current line 
Examples: 
TEXT COMMANDS PRINTOUT 

CMPB ICHAR, #833 V 

BEQ $ALT < 

CMPB HAR, #175 

BNE LACE > BNE PLACE 

Dot is here. Dot remains here. 


4.3.1.4 Next 


i 


Typing nN punches out the entire contents of the Page Buffer (followed by 

a trailer of blank tape if a form feed is the last character in the buffer), 
deletes the contents of the buffer, and reads the Next page into the buf- 
fer. It performs this sequence n times. If there are fewer than the n 
pages specified, the command will be executed for the number of pages ac- 
tually available, and a ? will be printed out. Following execution of a 
Next, Dot and Mark will be located at the beginning of the Page Buffer. 


4.3.1.5 Form Feed and Trailer 
F Punches out a Form feed character and four inches of 
blank tape 


nT Punches out four inches of Trailer (blank) tape n times 


4.3.1.6 Procedure with Low-Speed Punch 


. If the low speed punch is the specified output device (see Section 4.4.2), 
the Editor pauses before executing any tape command just typed (Punch, 

Form feed, Trailer, Next, wHole). The punch must be turned on at this time, 
after which, typing the SPACE bar initiates the execution of the command. 
Following completion of the operation, the Editor pauses again to let you 
turn the punch off. When the punch has been turned off, typing the SPACE 
bar returns ED-11 to Command Mode. 


4.3.2 Commands to Move Dot and Mark 


4.3.2.1. Beginning and End 


B . Moves Dot to the Beginning of the Page Buffer 


E Moves Dot to the End of the Page Buffer (see also /J and /A 
below) 


4.3.2.2 Jump and Advance 


nJ Jumps Dot forward past n nA Advances Dot forward past n 
characters ends-of-lines to the begin- 
ning of the succeeding line 
-nJ Moves Dot backward past n 7NA Moves Dot backwards across n ends- 
characters of-lines and positions Dot immedi- 


ately after n+l ends of lines, i.e., 
at the beginning of the -n line. 


.0J or OA Moves Dot to the beginning of the current line 
aJ or @A Moves Dot to the Marked location 
PIT Oe JA Moves Dot to the end of the Page Buffer (see also 
i E above) 
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Notice that while n moves Dot n characters in the Jump command, its role 
becomes that of a line counter in the Advance command. However, because 
0, @, and / are absolute, their use with these commands overrides line/ 
character distinctions. That is, Jump and Advance perform identical func- 


tions if both have either 0, @ or / for an argument. 


4.3.2.3 Mark 


The M command marks ("remembers") the current position of Dot for later 
reference in a command using the argument @. Note that only one position at 
a time can be in a marked state. Mark is also affected by the execution of 


those commands which alter the contents of the Page Buffer: 
ê D H I K N R Xx 
4.3.3 Search Commands 


4.3.3.1 Get 


The basic search command nG starts at Dot and Gets the nth occurrence of 
the specified text in the Page Buffer. If no argument is present, it is 
assumed to be l. When you type the command, followed by the RETURN key, 
ED-11 will go into Text Mode. The character string to be searched for must. 
now be typed. '" (ED-11 will accept a search object of up to 42 characters 
in length.) Typing the LINE FEED key terminates Text Mode and initiates 


the search. 


This command sets Dot to the position immediately following the found 
character string, and a OL listing is performed by ED-11l. If a carriage 
return, line feed, or form feed is specified as part of the search object, 
the automatic OL will only display a portion of text -- the part defined 
as the last line. Where any of these characters is the last character of 


the search object, the OL will of course yield no printout at all. 


If the search is unsuccessful, Dot will be at the end of the Page Buf- 
fer and a ? will be printed out. The Editor then returns to Command Mode. 
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Examples: 
d. Text Command Printout 
MOV @RMAX, 885 26) BEQ CK 
ADD #6, (R5)+ CK} 
CLR $CK3 
TST R2 
BEQ CKCR 
Dot was here. . Dot is now here. 
2. | CMPB, ICHAR, #RUBOUT Ga Z2 BR 
| BEQ SITE TE X 
‘ta PUT BRY 


Dot i Dot 


4.3.3.2 wHole 


A second search command, H, starts at Dot and looks through the wHole text — 
file for the next occurrence of the character string you have specified 

in Text Mode. It combines a Get and a Next such that if the search is not 
successful in the Page Buffer, the contents of the buffer are punched on. 
tape, the buffer contents are deleted, and. a new page is read in, where 

the search is continued. This will proceed until the search object is found 
or until the complete source text has been searched. In either case, Mark 
will be at the beginning of the Page Buffer. 


If the search object is found, Dot will be located immediately follow- 
ing it, and a 0L will be performed by ED-11. As in the Get command, if 
the search is not successful Dot will be at the end of the buffer and a ? 
will appear on the teleprinter. Upon completion of the command, the Editor 
will be in Command Mode. No argument is allowed. Note that an H command 
specifying a nonexistent search object can be used to close out an edit, 
i.e., copy all remaining text from the input tape to the output tape. 


4.3.4 Commands to Modify the Text 


4.3.4.1 Insert 


The Insert command (I) allows text to be inserted at Dot.. After I is typed 
(£ollowed by the typing of the RETURN key), the Editor goes into Text Mode 
| to receive text to be inserted. Up to 80 characters per line are accept- 
i able: Execution of the command occurs when the LINE FEED key (which does 
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not Insert a line feed character unless it is the first key typed in Text 
Mode) is typed terminating Text Mode. At this point, Dot is located in 

the position immediately following the last inserted text character. If 
the Marked location was anywhere after the text to be Inserted, Dot becomes 


the new Marked location. 


During an insert, it sometimes happens that the user accidentally types 
CTRL/P rather than SHIFT/P (for @), thus deleting the entire insert (see 
Section 4.4.1). To minimize the effect of such a mistake, the insert may 


be terminated every few lines and then continued with a new Insert command. 


As with the Read command, an attempt to overflow the Page Buffer will 
cause a ? to be printed out followed by an * on the next line indicating 
that a command may be typed. All or part of the last line typed may be 
lost. All previously typed lines will be inserted. Examples: 


Text Command Effect  .... 


1. MOV #8.,EKO f MOV #8.,EKOCNT 
CNY 


Dot Dot 


2. Inserting a carriage return (and automatic line feed): 


CLR RICLR R2 LJ CLR Rl 
2 CLR R2 
Do Y 
3: Inserting a single line feed: 
I9 
LOOK WHAT HAPPENS HERE 4 LOOK WHAT 
S 4 | HAPPENS HERE 
Dot 4 


Dot 


4.3.4.2 Delete and Kill 


These commands are closely related to each other; they both erase specified 
text from the Page Buffer. The Delete command (D) differs from the Kill 


‘command. (K) only in that the former accepts an argument, n, that counts | 
characters to be removed, while the latter accepts an argument, n, that 


counts lines to be removed. 0, 80, and / are also allowed as arguments. 


After execution of these commands, Dot becomes the Marked location. 
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nD Deletes the following n nK Kills the character string 
characters beginning at Dot and ending 
at the nth end-of-line 


-nD Deletes the previous n -nK Kills the character string 
characters beginning with the first 
character following the (n+1)th 
previous end-of-line and end- 





ing at Dot 
0D or OK Removes the current line up to Dot 
@D or GK | Removes the character string bounded by Dot and Mark 
/B ok XX Removes the character string beginning at Dot and 


ending with the last character in the Page Buffer 


Y 


Text -. Command l Effect 
1.  ;CHECK THE MOZXDE m ;CHECK THE T 
Dot’ . Do 
2. ;IS IT A TABOR 2K ;IS. IT A, TA 
| ;IS IT A CR 
Dot Dot. 


4.3.4.3 Change and eXchange 

The Change (C) and eXchange (X) commands can be thought of as two-phase 
commands combining, respectively, an Insert followed by a Delete, and 

an Insert followed by a Kill. After the Change or eXchange command is 
‘typed, ED-11 goes into Text Mode to receive the text to be inserted. If E 


tn is used as the argument, it is then interpreted as in the Delete (charac- 





ter-oriented) or Kill (line-oriented), and accordingly removes the indicated 
text. 0, 80, and / are also allowed as arguments. 


nc Changes the following nx eXchanges the character 

XXXX n characters XXXX . string beginning at Dot and 

XXXX XXXX ending at the nth end- 
of-line 

-nC Changes the previous 1 “nx eXchanges the character 


XXX n characters XXX  . string beginning with 
the first character fol- 
lowing the (n*l)th pre- 
vious end-of-line and 
ending at Dot . 


OC or OX Replaces the current line up to Dot 
XXXX XXXX : i 
XXXX XXXX 





ec or @X . Replaces the character string bounded by Dot 

XXX XXX and the Marked location 

XXX XXX 

/C or yX Replaces the character string beginning at Dot 

XXX XXX and ending with the last character in the Page 
Buffer. 


,Again, the use of absolute arguments 0, 8, and / overrides the line/character 


distinctions that n and -n produce in these commands. 


If the Insert portion of a Change or eXchange is termináted because of 
attempting to overflow the Page Buffer, data from the latest line may have. 
been lost, and text removal will not occur. Such buffer overflow might be 
'avoided by separately executing a Delete or Kill followed by an Insert, rather 
than a Change or eXchange, which does an Insert followed by a Delete or Kill. 


Examples: 
Text Command Effect 
;A LINE FEED IS HERE -9C ;A TAB, IS HERE 
TABY 
;THIS 2x JJ ;THIS og 
;IS ON Dot PAPER ;IS ON|. 
FOUR . ;PAPER 
Quas Ñ 
Dot Dòt 


4.4 OPERATING PROCEDURES 
4.4.l Error Corrections 


During the course of editing a page of the program, it may become necessary 
to correct mistakes in the commands themselves. There are four special 


. commands which do this: 


a. Typing the RUBOUT key removes the preceding typed character, 
if it is on the current line.  Successive RUBOUTs remove pre- 
ceding characters on the line (including the SPACE), one charac- 
ter for each RUBOUT typed. 


b. The CTRL/U combination (holding down the CTRL key and typing 
U) removes all the characters in the current line. 


C. CTRL/P cancels the current command in its entirety. This in- 
cludes all the current command text just typed, if ED-11l was 
in Text Mode. Care should be taken in not using another CTRL/P 
before typing a line terminator as this will cause an ED-11 re- 
start (see d. below). If CTRL/P is typed while 


a found search object of a Get or wHole is being 
printed out, the normal position of Dot (just after 
the specified search object) is not affected. 


CTRL/P should not be used while a punch operation 
is in progress as it is not possible to know exactly 
how much data will be output. 


d. Two CTRL/P's not interrupted by a typed line termi- 


nator will restart ED-11, initiating the dialogue 
described in Section 4.4.2. 


After'/ removing the incorrect command data, the user can, of course, 


directly type in the desired input. 


4.4.2 Starting 
The Editor is loaded by the Absolute Loader (see Chapter 6, Section 6.2.2) 
and starts automatically. Once the Editor has been loaded, the following 


Sequence occurs: 


ED-11 Prints User Types 7 


*I La (if the Low-speed Reader is to be used for 
source input) 


H (if the High-speed Rum is to be used far. 
source input) 


*O La” (if the Low-speed Punch is to be used for 
edited output) 


HJ (if the High-speed Punch is to be used for 
edited output) 


If all text is to be entered from the keyboard (i.e., via the Insert 
command), either L or H may be specified for Input. 


If the output device is the high-speed punch (HSP), the Editor enters 
Command Mode to accept input. Otherwise, the sequence continues with: 


LSP OFF? ») (when Low-speed Punch (LSP) is off) 


Upon input of » from the keyboard, the Editor enters Command Mode 


and is ready to accept input. 
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4.4.3 Restarting | i 
To restart ED-11, type CTRL/P twice. This will initiate the normal start- 

ing dialogue described in Section 4.4.2. If the Low-speed Reader (LSR) 

is in operation it must first be turned off. The text to be edited should 


be loaded (or reloaded) at this time. 


4.4.4 Creating a Paper Tape 
Input commands assume that text will be read in from a paper tape by means 
of the low-speed reader or high-speed reader. However, the five commands 
that go into Text Mode enable the user to input from the keyboard. The 
Insert command, in particular (Section 4.3.4.1) can be useful for enter- 
ing large quantities of text not on paper tape. The Page Buffer can thus 
be filled from the keyboard, and a paper tape actually created by then using 
a command to punch out the buffer contents. 


4.4.5 Editing Example 


The following example consists of three parts: | A 


a. The marked up source program listing indicating the desired 
changes. 


b. The ED-11 commands to implement those changes (with comments 
on the editing procedure). i 


REMINDER 
Typing the RETURN key terminates Command 
Mode in all cases. In commands which then 


go into Text Mode, typing the LINE FEED key 
(symbolized as +) produces the terminator. 


C. The edited text. 


PART I Original Source for Edit 
ICOMKON INPUT ROUTINE FOR USE BY NON FILE DEVICES 


SENPLTS ANC ICHAR,(R5)¢ JUPDATE CKSUM 

CLR -lLS) SCL EAR DONE 

«nv (49)*,RMAX IGET ADR MAX 

YNV (R5)+,MODADR IGFET ADR MODE 

JR5 NOK POINTS TO POINTER 

SOK Soe felis G^nDpAVLÉE, ASCII 31S HIS ASCII 

BNE CKBIN JNO---TRY BINARY 
Stk yue. TESTA ICHAR JASCII---15 CHAR A NULL 

REQ CK 1YES--NO GO 


m JLOOK AT MODE TO SEE IF — 
$CXPAR} PIIP — GMODADR,*PARSIT JSUPPOSED TO CHECK PARITY? 





RNE PAROK INO 
MOVB ICHAR, OCHAR IYES--=CK IT 
JSR R7,PARGEN 
Sug ICKAR OCHAR b 
REQ PAROK . 10K? 
ie BIS &PARERR,&VODADR JNO---SET ERR BIT 
PARO«:1 CLR CCHAR 
EIC #177233, ICHAR SSTRIP PARITY . 
CMPB @12(RADO),#K8D JIS THIS KBD INPUT 
BNE OKs INO 
TSTB EKOCNT JYES---DONE EKO OF LAST? 
REQ $0K IYES 
CLR ICHAR SNO=--DROP NEW CHAR -=x 
$JP2CK1 JMP CKA DUN 
IWHAT IS THE CHAR 
SoKi CMPB ICHAR, #CTRLC IIS IT A C ; 
BNE gen ————i88——————— —- Ok 
MOV BUPC,OCHAR IYESc--ECHO *C 
TNC ROUN pa 
MOV &ABRTÀD,20(R6) 1DIODLE RETURN ADR 
RR PLUSIL 


AR, #CTRLP 





i _ STHIS IS NOT KBD INPUT 
(ORE ER — eHSDRORTHPORMAT LES IMLS ASCH FORMATTEB? FORMATTED AUD 


3 PYESr rr BO—EHAR CON 
gee MOUUAPaE Eset Gory l 
hore tt ES Pu ee UNFIRMATTE py 


CMPB ICHAR, #RUBOUT JIS THIS A RUBOUT 


AR 
REQ CK JYES---1GNORE IT POMPE ED v Te wail 
RR PUT IN0--- "E 















(R5)+ 


TCHAR, &CTRLU 
CKTAS 

FUPU; CHAR I YES", -ECHO 
ICHA 

®RMYX,ERS a ak, 





A) 


Pus 











&6, RS)* 
CR 









CXTÀB: MPR ICHAR: #HTAB MS 17 A TAB 
RNE CKCR iNO 
MOV #BLNXS, OCHAR. )YES---ECHO BLANKS 
MOV TABCNT,EKOCNT ISET UP COUNTER 
RR PUT ] 
CKCR: CMPB ] CHAR, SCR 11S IT A CR? 
RNE $CK3 INO , 
MOV #CRLF»OCHAR IYES---ECHO CRLF 
TNC ROUN 1 
RR PLUS1 1 
US | BUTS 
SCK$1 CMPB ICHAR: #533 BS? te mt 
REQ SALT ,^ CHA : 
CMPB ICHAR, $175 z ON ALT MODE > 
RES SALT . 
MPA ICHAR» #176 -— 
RNE cke ~ EX 
"d vov #175, ICHAR 
ee aa a ee e e 
A pez C Bothy JOLT: 
CKLF3. CMPB ICHAR #LF 
RNE CKFF 
INC ROUN 
RR PUT 
CKFF1 MOV ICHAR, OCHAR 
CMPB ICHAR,#FF 
RNE PUT 
"nv #8,,EKOCNT 
“MOV #LFLF OCHAR 
RR PUT 


Part II: 


Assume that 


the reader. 


*R 

*H 
2CK:+ 
SIP 2CK: 


*G 
TKY 
SJP2CK JMP 


*G 
CKINP:+ 
CKINP: 


LS 


IE 


Underlined 


CK 


CKUPP 


Editing Session x 


ED-11 has been started, is in Command Mode, and the tape is 


matter indicates ED-11 output. 


;Reads in a page of text 
;Searches entire program for 2CK: — 


;when found ED-11 performs a OL 


;Searches current page for next CK — 
;when found ED-11 performs a 0L 


;Inserts DUN following CK 


;Searches for next CKUPP - 
;when found ED-11 performs a 0L 


;OKO replaces last 5 characters (CKUPP) 


;Dot is moved 6 lines ahead (including 
;a blank line) dis 


;9 lines are killed starting with CKUPP: 


;Next line is listed - Dot is not moved 
;THIS IS NOT KBD INPUT 


;Blank line is inserted 


;Dot is moved 1 line ahead to point to 
;character O of OKO: 


;Following comments replace the next 4 
;lines 

;FORMATTED AND UNFORMATTED 

;ASCII ARE HANDLED THE SAME} 


;Searches for next CKINP: — 


;0L printout occurs when found 


;Dot is moved to the beginning of the 
;current line. 


;The rest of the page is killed (3 lines) 











XN ;Current page is punched out on paper tape — 
;a new page is read in 

*L ;The next line is listed - Dot is not moved 

TST 2 (R5) +BC=G? 

*15K ;15 lines are killed Starting with TST 

"2L ;l blank line and 1 line of text 
;are listed - Dot is not moved 

CKTAB: CMPB ICHAR,#HTAB ;IS IT A TAB 

*26 ;Searches for 2nd occurrence of $CK3 - 

S$CK3* ;0L printout verifies it is found 

SCK3 i ` 

Test ;ALT replaces preceding character 

ALT* i 

*V ;Lists entire current line to verify 

SCKALT: CMPB ICHAR,4£33 ;the above -C result 

*G ;Searches for the 033 to position Dot 

$334 ;for next command -- OL occurs 

SCKALT: CMPB ICHAR, #933 

oe ithe following text is inserted in the 
;comment field . 

;IS CHAR AN ALTOMODE? 
^ ;Searches for next CKLF -- 0L occurs 
CKLFY 
BNE CKLF 

We 2C ;EX replaces the preceding two characters 

EX ; (LF) 

*2J ;Jumps Dot past the carriage return and 
;line feed characters 

*K ;Kills next line (starting with S$ALT:) 

Set ;Inserts SALT: at beginning of the fol- 

SALT: + ;lowing line 

*A ;Advances Dot past 1 line feed to the 
;beginning of the next line 

*M ;Marks the position of Dot 

*B ;Moves Dot to the beginning of the cur- 
;rent page 

*QPé— ;Punches out the lines from Dot to the 


;position just marked - Dot not moved 





Fi *?A | ;Moves Dot from the beginning of the 
;page to the marked position 


*2X ;Kills the next 2 lines 








STNP OT? 


SCKMADES 


SCENULI 


"5OKPARI 


PAROS 


$JP922K1 


SOx} 


PL SVS 


ADS 


Edited Source 


]«FuT ROUTINE FOR USE BY NON FILE DEVICES 


ICHAQ, ERE) & 
-(L5) 
(425)*,k*AX 
(R5) «4,402420 


Gv 0DALE, #ASCII 
CK8[N 


1 CHAR 
CK 


GCAQODADR, FPARBIT 
FAROK 

ICHAR, OCHAR 
R7,PARGEN 
ICHAR,OCHAR 
PAROK 

FPARERR, S4ONAOR 
CCAR 

#177266, ICHAR 
€iZ(RADOD,*KRD 
CK 


ICHAR 
CKOUN 


teoAT IS THE CHAR 


CMPS 
RKE 
EAV 
IAZ 
BEV 
RR 


evon 
RF 
RO 


ICHARI RCTRLC 
oKZ 

&ÜP C, QCHAR 
ROUN 
FABRTAD22(R6) 
PLuS1 


I CHAR, £RUROUT 
cx 
PUT 


JUPDATE CKXSUM 

HCL EAR DONE 

IGET ADR MAX 

)GFT ADR "ODE 

IR5 NOW POINTS TO POINTER 
31S THIS ASCII 

JNü---TRY BINARY 


JASCII*--IS CHAR A NULL 
)Y£S--N0 GO 


1LOnX AT MONE TO SEE IF 
ISUPPOSED TO CHECK PARITY? 
INO : 
)JYES»-4CK IT 

} 

10K? 

INO---SET ERR BIT 


ISTRIP PARITY 


JIS THIS KBD INPUT od 
INO 

IYESe--DONE EKO OF LAST? 

TII 


1NO-*-DROP NEW CHAR 


IIS IT A *C 
INO 
JYES--ECHO *C 


DIDDLE RETURN ADR 


STHIS IS NOT KBD INPUT 
IFORMATTED AND UNFORMATTEN 
JASCII ARE HANDLED THE SAME 
IIS THIS A4 RUBOUT 
HYES*-*16NORE IT 

JNO--- 


CKTA?1 curs TSAR PHT AS HIS IT a TAB 
RNE LACR INO 
rOy LOLWAS, OCHAR PYES@--ECHD RLANKS 
«nv TASCHT,EsOCMT ISET UP COUNTER 
ER PUT i 
CKOR? CMOR ICHAR: 8 CR MS IT A CR? 
BNE ¥oxX3 INO i 
NOV & CSLF OCHAR )YES---ECHO CRLF 
INC - ROUN 
RR FLUSH j 
SCKALTE CM9ü ICHAR,38033 MIS CHAR AX ALTXODE? ` 
RE SALT . 
CMP& 19248AR,K175 
RFG WALT 
CMP 1 CHAR, #176 
ANE - CKEX 
SALT: Mny 175., ICHAR ; 
CKI F1 CMER ICAAR,SLF 
ENE cKFF 
TAG POUN 
AR FUT . AN, 
| ! CKFFi1 mey ICHAR, OCHAR 
COMPR ICHAR, AFF 
RNE PUT 
MOV #U,,EKOCNT 
May PLFLF » GCHAR . 
RR FUT 





4.5 SOFTWARE ERROR HALTS u 


ED-11 loads all unused trap vectors with the code 


.WORD .+2,HALT 
I 
So that if the trap does occur, the processor will halt in the second word 

of the vector. The address of the halt, displayed in the console address 
register, therefore indicates the cause of the halt. In addition to the 

halts which may occur in the vectors, the standard IOX error halt at loca- 
tion 40 may occur (see Chapter 7). 


Address of HALT Meaning 
12 Reserved instruction executed 
16 Trace trap occurred 
26 Power fail trap 
32 EMT executed 
36 TRAP executed GI 
40 IOX detected error 
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CHAPTER 5 


DEBUGGING OBJECT PROGRAMS ON-LINE | 


5.1 INTRODUCTION 

ODT-11 (On-line Debugging Technique for the PDP-11) is a system program 
which aids in debugging assembled object programs. From the Teletype 
keyboard you interact with ODT and the object program to: 


9 print the contents of any location for examination or 
alteration, 





e run all or any portion of your object program using the 
breakpoint feature, D 


search the object program for specific bit patterns, 


search the object program for words which reference a specific 
word, | 


fe) Calculate offsets for relative addresses. 


During a debugging session you should have at the teleprinter the. 
assembly listing of the program to be debugged. Minor corrections to the 
program may be made on-line during the debugging session. The program may 
then be run under control of ODT to verify any change made. Major. correc- 
tions, however, such as a missing subroutine, should be noted on the 
assembly listing and incorporated in a subsequent updated program assembly. 


A binary tape of the debugged program can be obtained by use of the 
DUMPAB program (see Chapter 6, Section 6.3). 


5.1.1 ODT-11 and ODT-11X 

There are two versions of ODT included in the PDP-11 Paper Tape Software 
System: -a standard version, ODT-ll, and an extended version, ODT-11X. 

Both versions are independent, self-contained programs.  ODT-11X has all 

the features of ODT-11, plus some additional features. . Each version is xe 
supplied on two separate paper tapes: a source tape and an absolute 

binary tape. The purpose of the tapes, and loading and starting procedures 


are explained in a later section of this chapter. 


ODT-1ll is completely described in Section 5.2, and the additional 
features of ODT-11x are covered in Section 5.3. In all sections of this 
chapter, except where specifically stated, reference to ODT applies to` 
both versions. Concluding sections are concerned with ODT's internal 


i Bei 








operations -- how breakpoints are effected, how it uses the "trace trap" 
and the T-bit, and other useful data. Such information is not necessary 
to efficiently use ODT, but is available for anyone desiring such in- 


depth information. 


The following discussion assumes that the reader is familiar with 
the PDP-ll instruction formats and the PAL-11A Assembly Language as 
described, in Chapter 3. 


5.1.2 ODT's Command Syntax 


ODT's commands are composed using the following characters and symbols. 
They are often used in combination with the address upon which the opera- 
tion is to occur, and are offered here for familiarization prior to 

their thorough coverage which follows. Unless indicated otherwise, 


n below represents an octal address. 


n/ open the word at location n 
7 reopen last opened location E. 
n\ (SHIFT/L) open the byte at location n (ODT-11X only) 


reopen the last opened byte (ODT-11X only) 


+ (LINE FEED key) open next sequential location 
re open previous location 
RETURN close open location and accept the next command 
g take contents of opened location, index by contents of 


PC, and open that location 


@ take contents of opened location as absolute address and 
open that location (ODT-11xX only) 


> take contents of opened location as relative branch 
instruction and open referenced location (ODT-11X only) 


M return to sequence prior to last @, >, or + command 
and open succeeding location (ODT-11X only) 


$n/ open general register n (0-7) 





‘The circumflex, ^, appears on some keyboards and printers in place 
of the up-arrow. . 


^The underline, .:. appears on some keyboards and printers: in place 
of the back-arrow. i ; 
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: separates commands from command arguments (used with 
alphabetic commands below) 


;B remove Breakpoint(s) (see description of each ODT 
version for particulars) 


n;B set Breakpoint at location n 

n;rB set Breakpoint r at location n (ODT-11X only) 
;rB remove gon Breakpoint (ODT-11Xx only) 

n;E . Search for instructions that reference Effective 


address n 
n;W search for Words with bit patterns which match n 


;n$ enable Single-instruction mode .(n can have.any. value 
and is not significant); disable breakpoints : 


7S disable Single-instruction mode 

n;G Go to location n and start program run 

SP Proceed with program execution from breakpoint; stop 
when next breakpoint is encountered or at end of 
program — 


In Single-instruction mode ply (ODT- 11x), Proceed to 
execute next instruction only 


IP Proceed with program execution from breakpoint; 
Stop after encountering the breakpoint n times. 
In Single-instruction mode only (ODT- 11X), Proceed to 
execute next n instructions. 


n/(word)m;O calculate Offset from location n to location m. 


$8/ ODT-11, open Breakpoint status word 
ODT-11X, open Breakpoint 0 status word 
$M/ open search Mask 
$S/ open location containing user program's Status register 
$P/ open location containing ODT's Priority level 


With ODT-11, location references must be to even numbered 16-bit words. 
With ODT-11X, location references may be to l6-bit words or 8 bit 
bytes. 


‘The semicolon in the above commands is ignored by ODT-1ll, but is 


used for the sake of consistency, since similar commands to ODT-11X 


require its 








5.2 COMMANDS AND FUNCTIONS 


When ODT is started as explained in Section 5.6, it will indicate its 
readiness to accept commands by printing an asterisk on the left margin 
of the teleprinter paper. In response to the asterisk, you can issue 
most commands; for example, you can examine and, if desired, change a 
word, run the object program in its entirety or in segments, or even 
search core for certain words or references to certain words. The dis- 
cussion below will first explain some elementary features before covering 


the more sophisticated features. 


All commands to ODT are stated using the characters and symbols 
shown above in Section 5.1.2. l 


5.2.1 Opening, Changing, and Closing Locations 


An open location is one whose contents ODT has printed for examination, 
and whose contents are available for change. A closed location is one 
whose contents are no longer available for change. Any even-numbered 
location may be opened using ODT-11. 


The contents. of an open location may be changed by typing the new . 
contents followed by a single character command which requires no argu- 
ment (i.e., +, + RETURN, +, @, >, <). Any command typed to open a loca- 
tion when another location is already open, will first cause the 
currently open location to be closed. 


5.2.1.1 The Slash, / 


One way to open a location is to type its address followed by a slash: 
*1000/012746 

Location 1000 is open for examination and is available for change. Note 

that in all examples ODT's printout is underlined; your typed input is 


not. 


Should you not wish to change the contents of an open location, 


merely type the RETURN key and the location will be closed; ODT will 
print another asterisk and wait for another command, However, should 
you wish to change the word, simply type the new contents before 


giving a command to close the location. 


cipi SE 012345 


In the example above, location 1000 now contains 012345 and is closed . 
since the RETURN key was typed after entering the new contents, as 
indicated by ODT's second asterisk. 


Used alone, the slash will reopen the last location opened: 


*1000/012345 2340 
*/002340 


As shown in the example above, an open location can be closed by typing 
the RETURN key. In this case, ODT changed the contents of location 1000 
to 002340 and then closed the location before printing the *. We then 
typed a single slash which directed ODT to reopen the last location f | 
opened. This allowed us to verify that the word 002340 was correctly | 
Stored in location 1000.  (ODT supplies the leading zeroes if not | 
given.) 

Note again that opening a location while another is currently open 
will automatically close the currently open location before opening the 


new location. 


5.2.1.2 The LINE FEED Key 


If the LINE FEED key is typed when a location is open, ODT closes the 
open location and opens the next sequential location: 


*1000/002340 + (+ denotes typing the LINE FEED key) 
0010027012740 


In this example, the LINE FEED key instructed ODT to print the address 
of the next location along with its contents and to wait for further 
instructions. After the above operation, location 1000 is closed and 


i 525 


TT—————————————————————————————————————————————— — 


1002 is open. The open location may be modified by typing the new 


contents. 


5.2.1.3 The Up-Arrow, + 

The up-arrow (or circumflex) symbol is effected by typing the SHIFT 
and N key combination. If the up-arrow is typed when a location is 
open, ODT .closes the open location and opens the previous location 


(as shown by continuing from the example above): 


001002/012740 + {tis printed by typing SHIFT and N) 
001000/002340 | 


Now location 1002 is closed and 1000 is open. The open location may 
be modified by typing the new contents. 


5.2.1.4 The Back-Arrow, + 


The back-arrow (or underline) symbol is effected by typing the SHIFT 
and O key combination. If the back-arrow is typed to an open location, 
ODT interprets the contents of the currently open location as an 
address indexed by the Program Counter (PC) and opens the location so 


addressed: 


*1006/000006 - (+ is printed by typing SHIFT and O) 
001016/100405 


Notice in this example that the open location, 1006, was indexed by 
the PC as if it were the operand of an instruction with address mode 


67 as explained in Chapter 3. 


A modification to the opened location can be made before a t,4, 
Or - is typed. Also, the new contents of the location will be used 


for address calculations using the * command. Example: 


*100/000222 4+ (modify to 4 and open next location). 
0001027000111 6 + (modify to 6 and open previous location) 
000100/000004 100+ (change to 100 and open location indexed 
000202/ (contents) by PC) 


5.2.1.5 Accessing General Registers 0-7 


The program's general registers 0-7 can be opened using the following 


command format: 


"in 


where n is the integer representing the desired register (in the range 
0 through 7). When opened, these registers can be examined or changed 
by typing in new data as with any addressable location. For example: 





*$0/000033 (RO was examined and closed) 
F ; 
and | 
*$4/000474 464 (R4 was opened, changed, and closed) 
* 


The example above can be verified by typing a slash in response to 
ODT's asterisk: 


*/000464 


The *, 4 *, or 8 commands may be used when a register is open (the 
@ is an ODT-11X command). 


5.2.1.6 Accessing Internal Registers 


The program's Status Register contains the condition codes of the most 
recent operational results and the interrupt priority level of the 
object program. It is opened using the following command: 


*$S/000311 


where $S represents the address of the Status Register. In response 

^to $S/ in the example above, ODT printed the 16-bit word of which only 
the low-order 8 bits are meaningful: Bits 0-3 indicate whether a carry, 
overflow, zero, or negative (in that order) has resulted, and bits 5-7 
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indicate the interrupt priority level (in the range 0-7) of the object 
program. (See Chapter 1 of this manual or the PDP-11 Handbook 
for the Status Register format.) 


The $ is used to open certain other internal locations: 


$B internal breakpoint status word (see Section 5.2.2.2) 
$M mask location for specifying which bits are to be 
` examined during a bit pattern search (see Section 
5.2.4) 
$P location defining the operating priority of ODT ` 


(see Section 5.2.6) `, 


$S - location containing the condition cođes (bits 0-3) 
and interrupt priority level (bits 5-7) 


5.2.2 Breakpoints. 


The breakpoint feature facilitates monitoring the progress of program 
execution. A breakpoint may be set at any instruction which is not 
referenced by the program for data. When a breakpoint is set, ODT 
replaces the contents of the breakpoint location with a trap instruc- 
tion so that when the program is executed and the breakpoint is 
encountered, program execution is suspended, the original contents. 
of the breakpoint location are restored, and ODT regains control. 


5.2.2.1 Setting the Breakpoint, n;B 


ODT-11 provides only one breakpoint (ODT-11X provides eight break- 
| points). However, the breakpoint may be changed at any time. The 
| breakpoint is set by typing the address of the desired location of 
the breakpoint followed by ;B. For example: 





*1020;B 
ua 


| ‘sets the breakpoint at location 1020. The breakpoint above is 
| changed to location 1120 as shown below. 


*1020;B 
*1120;B 
* 


Breakpoints should not be set at locations which are referenced 
by the program for data, or on an IOT, EMT, or TRAP instruction. This 
restriction is explained in Section 5.5.2. 


The breakpoint is removed by typing ;B without an argument, as 
shown below. 


*1120;8 (sets breakpoint at location 1120) 


*;B (removes breakpoint) 
* 


5.2.2.2 Locating the Breakpoint, $B 


The command $B/ causes the ODT-11 version to print the address of | 
the breakpoint (see also Section 5.3.3 on $B in ODT-11X): __ 


*$B/001120 


The breakpoint was set at location 1120. $B represents the address 
containing ODT-11's breakpoint location. Typing the RETURN key in 
the example above will leave the breakpoint at location 1120 and 
return control to ODT-11, or the breakpoint could be changed to a 
different location: 


*$B/001120 1114 
*$B/001114 
* 


— 


The breakpoint was found in location 1120, changed to location 1114, 
and the change was verified. l 


If no breakpoint was set, $B contains an address internal to 
ODT-11. 





E UM UNUM UM A E N 


5.2.3 Running the Program, n;G and n;P 

Program execution is under control of ODT. There are two commands for 
running the program: n;G and n;P. The n;G command is used to start 
execution (Go) and n;P to continue (Proceed) execution after having 


 halted at a breakpoint. For example: 
*1000;G 


starts execution at location 1000. The program will run until encounter- 
ing a breakpoint or until program completion, unless it gets caught in 
an infinite loop, where you must either restart or reenter as explained 


in Section 5.6.2. 


When a breakpoint is encountered, execution stops and ODT-1ll prints 
B; followed by the address of the breakpoint. You may then examine 
desired locations for expected data. For example: | 


— e 


*1010;B (breakpoint is set at location 1010) 
*1000;G (execution started at location 1000) 
B;001010 (execution stopped at location 1010) 
—— 


To continue program execution from the breakpoint, type.;P in 


response to ODT-ll's last *. 


When a breakpoint is set in a loop, it may be desirable to allow 
the program to execute a certain number of times through the loop before 
recognizing the breakpoint. This may be done by typing the n;P command 
and specifying the number of times the breakpoint is to be encountered 
before program execution is suspended (on the nth encounter). (See 
“Section 5.3.3 for ODT-llX interpretation of this command when more 


than one breakpoint is set in a loop.) 


Example: 
B;001010 (execution halted at breakpoint) 
*1250;8 (set breakpoint at location 1250) 
. 54;P (continue execution, loop through 
B;001250 breakpoint 3 times and halt on the 
* 4th occurrence of the breakpoint) 


— 
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The breakpoint repeat count can be inspected by typing $B/ and 
following that with the typing of LINE FEED. The repeat count will 
then be printed. This also provides an alternative way of specifying 
the count. The location, being open, can have its contents modified 
in the usual manner by the typing of new contents and then the RETURN 


*$B/001114 + (address of breakpoint is 1114) 
nnnnnn/000003 6 (repeat count was 3, changed to 6) 
E oe a . 


\ 


Breakpoints are inserted when performing an n;G or n;P command. 
Upon execution of the n;G or n;P command, the general registers 0-6 
are set to the values in the locations specified as $0-$6 and the 
processor status register is set to the value in the location specified 


as $S. ae 


3.2.4 Searches 


With ODT you can search all or any specified portion of core memory 
for any specific bit pattern or for references to a specific location. 


The location represented by $M is used to specify the mask of 
the search. The next two sequential locations contain the lower and 
upper limits of the search. Bits set to l in the mask will be 


examined during the search; other bits will be ignored. For example, 


*$M/000000 177400 + (+ denotes typing LINE FEED) 
nnnnnn/000000 1000 ¥ (starting address of search) 
nnnnnn/000000 1040 (last address in search) 

* - , 


where nnnnnn represents some location in ODT. This location varies 
and is meaningful only for reference purposes. Note that in the first 
ine above, the slash was used to open $M which now contains 177400, 
and that the LINE FEEDs opened the next two sequential locations which 


ra 


now contain the lower and upper limits of the search. 





5.2.4.1 Word Search n;W 


w 


efore initiating a word search, the mask and search limits must be 
specified as explained above. Then the search object and the initiat- 
ing command are given using the n;W command where n is the search 
object. When a match is found, the address of the unmasked matching 


word is printed. For example: 


*$M/000000 177400 + (test high order eight bits) 
nnnnnn/000000 1000 + 
nnnnnn/000000 1040 

*400;W (initiating word search) 
001010/000770 f 
001034/000404 


* 


In the search process, the word currently being examined and 
the search object are exclusive ORed (XORed), and the result is 
ANDed to the mask. If this result is zero, a match has been found, 
and is reported on the teleprinter. Note that if the mask is zero, 


-= — 


all locations within the limits will be printed. 


5.2.4.2 Effective Address Search, n;E 


ODT enables you to search for words which address a specified loca- 
‘ction. After specifying the search limits (Section 5.2.4), the command 
n;E is typed (where n is the effective address), initiating the search. 


Words which are either an absolute address (argument n itself), a 
relative address offset, or a relative branch to the effective address 
will be printed after their addresses. For example: 


*$M/177400 + 
nnnnnn/001000 1010 4 


nnnnnn/001040 1060 


*1034;E (initiating search) 
001016/001006 (relative branch) 
001054/002767 (relative branch) 

*1020;E (initiating a new search) 
001022/177774 (relative address offset) 
001030/001020 l (absolute address) 


* 


a 
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Particular attention should be given to the reported references 
to the effective address because a word may have the specified bit 
pattern of an effective address without actually being so used. ODT 


will report these as well. 


5.2.5 Calculating Offsets, n;0 
Relative addressing and branching involve the use of an offset - the 
number of words or bytes forward or backward from the current location 
to the effective address. During the debugging session it may be 
necessary to change a relative address or branch reference by replac- 
ing one instruction offset with another. | ODT calculates the offsets 

' for you in response to its n;O command. 


The command n;O causes ODT to print the 16-bit and 8-bit offsets 
from the currently open location to address n. In ODT-11, the 8-bit . 


offset is printed as a l6-bit word. For example: 


*346/000034 414;0 000044 000022 22 


*/000022 | 
*20/000046  200;0 000156 000067 67 
*20/000067 i 


In the first example, location 346 is opened and the offsets from 

. that location to location 414 are calculated and printed. The contents 
of location 346 are then changed to 22 and verified on the next line. 
The 16-bit offset is printed followed by the 8-bit offset. In the 
example above, 000156 is the 16-bit offset and 000067 is the 8-bit 
offset. 


The 8-bit offset is printed only if the 16-bit offset is even, as 
was the case above. With ODT-11 only, the user must determine whether 
the 8-bit offset is out of the range of 177600 to 000177 (712819 to 
12719). The offset of a relative branch is calculated and modified. 


as follows: 


*1034/103421 1034;0 177776 177777 . 103777 
* cai GARG pa) Ae 


~~ 


Note that the modified low-order byte 377 must be combined with. the 


- 
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unmodified high-order byte. Location 1034 was still open after the 
calculation, thus typing 103777 changed its contents; the location 


was then closed. 


5.2.6 ODT's Priority Level, $P 

$P represents a location in ODT that contains the priority level at 
which ODT operates. If $P contains the value 377, ODT will operate 
at the priority level of the processor at the time ODT is entered. 
Otherwise $P may contain a value between 0 and 7 corresponding to the 


fixed priority at which ODT will operate. 


To set ODT to the desired priority level, open $P.- ODT will 
print the present contents, which may then be changed: 


*$P/000006 137 
* 


If $P is not specified, its value will be seven. 


Breakpoints may be set in routines at different priority levels. 
For example, a program running at a low priority level may use a 
, device service routine which operates at a higher priority level. If 
a breakpoint occurs from a low priority routine, if ODT operates at 
a low priority, and if an interrupt does occur from a high priority 
routine, then the breakpoints in the high priority routine will not 


be executed since they have been removed. 


5+3 QODT-LIX 


ODT-11X has all the commands and features of ODT-11 as explained in 
Section 5.2, plus the following. 


5.3.1 Opening, Changing and Closing Locations 


In addition to operating on words, ODT-11X operates on bytes. 


One way to open a byte is to type the address of the byte 
followed by a backslash: 


. *1001\ 025 ( \ is printed by typing SHIFT and L) 
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A backslash typed alone will reopen the last open byte. If a word 
was previously open, the backslash will reopen its even byte. 


*1002/000004\ 004 


The LINE FEED and up-arrow (or circumflex) keys will operate on bytes 


if a byte is open when the command is given. For example: 


*1001\025 + 
001002N004 + 
001001\025 
* 


5.3.1.1 Open the Addressed Location, @ 


The symbol @ will optionally modify, close an open word, and use its 


contents as the address of the location to open next. 


*1006/001024 @ (open location 1024 next) 
001024/000500 

*1006/001024 2100 8 (modify to 2100 and open... 
002100/177774 location 2100) 


5.3.1.2 Relative Branch Offset, » 
The right angle bracket, », will optionally modify, close an open 


word, and use its even byte as a relative branch offset to the next. 


word opened. 


*1032/000407 301 > (modify to 301 and interpret as 
000636/000010 a relative branch) 


Note that 301 is a negative offset (-77). The offset is doubled be- 
fore it is added to the PC; therefore, 1034 + -176 = 636. 


5.3.1.3 Return to Previous Sequence, < 


The left angle bracket, <, will optionally modify, close an open 
location, and open the next location of the previous sequence 
interrupted by a+, @, or > command. Note that +, @, or > will 
cause a sequence change to the word opened. If a sequence change 
has not occurred, < will simply open the next location as a LINE 


FEED does. The command will operate on both words and bytes. 
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*1032/000407 301 > (> causes a sequence change) 
020636/000010 « (< causes a return to original 
PAP PCM sequence) 

301034/001040 @ (@ causes a sequence change) 
001040/000405\ 005 « (< now operates on byte) 
001035\ 002 , — (< acts like + ) 


001036AX 004 


5.3.2 Calculating Offsets, n;O 


The command n;O, causes ODT to print the l6-bit and 8-bit offsets from 
the currently open location to address n. The following examples, 
repeated from the ODT-11 section describing this command (see Section 


' 5.2.5), show only a difference in printout format: 


*346/000034 414;0 000044 022 22 
*/000022 — R M 


*1034/103421 1034;0 177776 377\ 021 377 

*/103717 
Note that the modified low-order byte 377 must be combined with the | 
unmodified high-order byte. 


5.3.3. Breakpoints 


With ODT-11X you can, at any one time, have up to eight breakpoints set, 
numbered 0 through 7. The n;B command used in ODT-11 to set the break- 
point at address n will set the next available breakpoint in ODT-llX. 
Specific breakpoints may be set or changed by the n;mB command where m 
.is the number of the breakpoint. For example: | | 


*1020;B (sets breakpoint 0) 
*1030;B (sets breakpoint 1) 
*1040;B (sets breakpoint 2) 
*1032:18 (resets breakpoint 1) 
* 


The ;B command used in ODT-11 to remove the only breakpoint will remove 
all breakpoints in ODT-11X. To remove only one of the breakpoints, the f 
. ;nB command is used, where n is the number of the breakpoint. For example: 
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> 2B (removes the second breakpoint) 


| +l + 


The $B/ command will open the location containing the address of 
breakpoint 0. The next seven locations contain the addresses of the 
other breakpoints in order, and thus can be opened using the LINE FEED 
key. (The next location is for Single-instruction mode, explained in 
. the next section.) Example: ` 


*$B/001020 Y 
nnnnnn/001032 + 
nnnnnn/(address internal to ODT) : 


In this example, breakpoint 2 is not set. The contents will be an 
.address internal to ODT. After the table of breakpoints is the table 
of Proceed command repeat counts for each breakpoint, and for the Single- 





instruction mode (see Section 5.3.4). 


» E. l 
nnnnnn/001036 + (address of breakpoint 7) 
nnnnnn/nnnnnn + (single-instruction address) 
nnnnnn/000000 15 + (count for breakpoint 0) 
nnnnnn/000000 (count for breakpoint 1) 


It should be noted that a repeat count in a Proceed command refers 
only to the breakpoint that has most recently occurred. Execution of 
other breakpoints encountered is determined by their own repeat counts. 


5.3.4 Single-Instruction Mode 

With this mode you can specify the number of instructions you wish 
executed before suspension of the program run.. The Proceed command, 
instead of specifying a repeat count for a breakpoint encounter, specifies: 
the number of succeeding instructions to be executed. Note that break- 


points are disabled when single-instruction mode is operative. 





Commands for single-instruction mode follow: 


;n$ Enables Single-instruction mode (n can have any 
value and serves only to distinguish this form 
from the form ;S); breakpoints are disabled. 


nie Proceeds with program run for next n instructions 
before reentering ODT (if n is missing, it is 
assumed to be 1). (Trap instructions and 
associated handlers can affect the Proceed repeat 
count. See Section 5.5.2.) 


7s Disables Single-instruction mode 


When the repeat count for Single-instruction mode is exhausted 
and the program suspends execution, ODT prints: 


Seis 


where n is the address of the next instruction to be executed,_ The 
$B breakpoint table contains this address following that of break- 
point 7. However, unlike the table entries for breakpoints 0-7, the 
B8 entry is not affected by direct modification. 


Similarly, following the repeat count for breakpoint 7, is the 
repeat count for Single-instruction mode. This table entry, however, 
may be directly modified, and thus is an alternative way of setting 
the Single-instruction mode repeat count. In such a case, ;P. implies 
the argument set in the $B repeat count table rather than the argument l1. 


5.4 ERROR DETECTION 


ODT-11 and ODT-11X inform you of two types of errors: illegal or 
unrecognizable command and bad breakpoint entry. 


Neither ODT-11 nor ODT-11X checks for the legality of an address 


when commanded to open a location for examination or modification. 
Thus, the command 
IT 4E 
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will reference nonexistent memory, thereby causing a trap through the 
vector at location 4. If this vector has not been properly initialized 
(by IOX, or the user program if IOX is not used), unpredictable results 


will occur. 
Similarly, a command such as 
$20/ 


which references an address eight times the value represented by $2, 
may cause an illegal (nonexistent) memory reference. . ` 
\ : 
Typing something other than a legal command will cause ODT to 


ignore the command, print 


| Hv 


~ 


and wait for another command. Therefore, to cause ODT to ignore a 
command just typed, type any illegal character (such as 9 or RUBOUT) 
and the command will be treated as an error, i.e., ignored. 


ODT suspends program execution whenever it encounters a breakpoint, 
i.e., a trap to its breakpoint routine. If the breakpoint routine is 
entered and no known breakpoint caused the entry, ODT prints: 


BE001542 
EXT 


and waits for another command. In the example above, BE001542 denotes. 
Bad Entry from location 001542. A bad entry may be caused by an 
illegal trace trap instruction, setting the T-bit in the status 
register, or by a jump to the middle of ODT. 


5.5 PROGRAMMING CONSIDERATIONS 


Information in this section is not necessary for the efficient use of 














ODT. However, its content does provide a better understanding of 


how ODT performs some of its functions. 


5.5.1 Functional Organization 


The internal organization of ODT is almost totally modularized into 
independent subroutines. The internal structure consists of three 
major functions: command decoding, command execution, and various 
utility routines. 


The command decoder interprets the individual commands, checks 
for command errors, saves input parameters for use in command execution, 
and sends control to the appropriate command execution routine. 


The command execution routines take parameters saved by the 
command decoder and use the utility routines to execute the specified 
command. Command execution routines exit either to the object program 
or back to the command decoder. 

The utility routines are common routines such as SAVE-RESTORE 
and I/O. They are used by both the command decoder and the command 


executers. 


Communication and data flow are illustrated in Figure 5-1. 


5a D2 Breakpoints 


The function of a breakpoint is to give control to ODT whenever the 
user program tries to execute the instruction at the selected address. 
Upon encountering a breakpoint, the user can utilize all of the ODT 


commands to examine and modify his program. 


When a breakpoint is executed, ODT-11(X) removes (all) the break- 
-point instruction(s) from the user's code so that the locations may 
be examined and/or altered. ODT then types a message to the user of 
the form Bn(Bm;n for ODT-11X) where n is the breakpoint address 
(and m is the breakpoint number). The breakpoints are automatically 


restored when execution is resumed. - 


.A major restriction in the use of breakpoints is that the word 
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Figure 5-1 Communication and Data Flow 
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where a breakpoint has been set must not be referenced by the program l 


in any way since ODT has altered the word. Also, no breakpoint should 
be set at the location of any instruction that clears the T-bit. For 


example: 
MOY #240,177776 ;SET PRIORITY TO LEVEL 5. 


A breakpoint occurs when a trace trap instruction (placed in the user t 
program by .ODT) is executed. When a breakpoint occurs, the following 


steps are taken: 


l. Set processor priority to seven (automatically set by li 
trap instruction). 4 


. Save registers and set up stack. 


2 
3. If internal T-bit trap flag is set, go to step 13. 
4. Remove breakpoint(s). 

2 


. Reset processor priority to ODT's priority or user's 
priority. 


6. Make sure a breakpoint or Single-instruction mode caused Cg 
the interrupt. s i 


7. If the breakpoint did not cause the interrupt, go to 
step 15. 


8. Decrement. repeat count. 
9. Go to step 18 if non-zero, otherwise reset count to one. 
10. Save Teletype status. 


ll. Type message to user about the breakpoint or Single- 
instruction mode interrupt. f 


12. Go to command decoder. 

13. Clear T-bit in stack and internal T-bit flag. 
14. Jump to the "GO" processor. 

15. Save Teletype status. 

16. Type "BE" (Bad Entry) followed by the address. 


17. Clear the T-bit, if set, in the user status and proceed 
to the command decoder. 


18. Go to the "Proceed" processor, bypassing the TTY restore 
routine. 


Note that steps 1-5 inclusive take approximately 100 microseconds 
during which time interrupts are not permitted to occur (ODT is running 
at level 7). 


When a proceed (;P) command is given, the following occurs: 


l. The proceed is checked for legality. 
2. The processor priority is set to seven. 


The T-bit flags (internal and user status) are set. 
m 


e w 


The user registers, status, and Program Counter are 
restored. 


ur 


Control is returned to the user. 


When the T-bit trap occurs, steps l, 2, 3, 13, and 14 
of the breakpoint sequence are executed,.breakpoints 
are restored, and program execution resumes normally. 


When a breakpoint is placed on an IOT, EMT, TRAP, or any instruc- 





tion causing a trap, the following occurs: 


l. When the breakpoint occurs as described above, ODT 
is entered. 


2. When ;P is typed, the T-bit is set and the IOT, EMT, TRAP, 
or other trapping instruction is executed. 


3. This causes the current PC and status (with the T-bit 
included) to be pushed on the stack. 


4. The new PC and status (no T-bit set) are obtained from 
the respective trap vector. 


5. The whole trap service routine is executed without any 
breakpoints. 


6. When an RTI is executed, the saved PC and PS (including 
the T-bit) are restored. The instruction following the 
trap-causing instruction is executed. If this instruc- 
tion is not another trap-causing instruction, the T-bit 
trap occurs, causing the breakpoints to be reinserted in 
the user program, or the Single-instruction mode repeat 
count to be decremented. If the following instruction is 
a trap-causing instruction, this sequence is repeated, 
starting at step 3. 


NOTE 


Exit from the trap handler must be via the RTI in- 
struction. Otherwise, the T-bit will be lost. ODT 
will not gain control again since the breakpoints 
have not been reinserted yet. 


In ODT-l11, the ;P command is illegal if a breakpoint has not 
occurred (ODT will respond with ?). In ODT-1lX, ;P is legal after 


any. trace tiup entry. 





WARNING 


Since CDT-1ll ignores all semicolons, typing the 
ODT-11X form of breakpoint command number to 
ODT-11, specifying a breakpoint number n, causes 
the following error: 


100;B (sets the breakpoint at location 100) 
100;0B (sets the breakpoint at location 1000) 
100;4B (sets the breakpoint at location 1004) 


The internal breakpoint status words for ODT-11 have the following 


l. The first word contains the breakpoint address.. If 
this location points to a location within ODT, it is 
assumed no breakpoint is set for the cell(specifically, 
ODT has set a dummy breakpoint within itself). 


2. The next word contains the breakpoint repeat count. 
Por ODT-11X (with eight breakpoints) the formats are: 


l. The first eight words contain the breakpoint addresses 
for breakpoints 0-7. (The ninth word contains the ^ 
address of the next instruction to be executed in 
Single-instruction mode.) 


2. The next eight words contain the respective repeat 
counts. (The following word contains the repeat count 
for Single-instruction mode.) 


These words may be changed at will by the user, either by using the 


breakpoint commands or by direct manipulation with $B. 


When program runaway occurs (that is, when the program is no 
longer under ODT control, perhaps executing an unexpected part of 
the program where a breakpoint has not been placed) ODT may be 
civen control by pressing the HALT key to stop the machine, and 
restarting ODT (see Section 5.6.2). ODT will print *, indicating 


that it is ready to accept a command. 


I= zhe program being debugged uses the Teletype for input or 
output, the program may interact with ODT to cause an error since 
ODT uses the Teletype as weli. This interactive error will not 


occur when the program being debugged is run without ODT. 


l. If the Teletype printer interrupt is enabled upon entry 

i to the ODT break routine, and no output interrupt is 
pending when ODT is entered, ODT will generate an unex- 
pected interrupt when returning control to the program. 


2. If the interrupt of the Teletype reader (the keyboard) 
i is enabled upon entry to the ODT break routine, and the 
program is expecting to receive an interrupt to input a 
. character, both the expected interrupt and the character 
‘will be lost. 


3.. If the Teletype reader (keyboard) has just read a char- 
acter into the reader data buffer when the ODT break 
routine is entered, the expected character in the 
reader data buffer will be lost. ` 


5.5.3 Search 


The word search allows the user to search for bit patterns in specified 
sections of memory. Using the $M/ command, the user specifies a mask, 
a lower search limit ($M+2), and an upper search limit ($M+4). The 
Search object is specified in the search command itself. 

The word search compares selected bits (where ones appear in the 
mask) in the word and search object. If all of the selected bits are 


equal, the unmasked word is printed. 
Tne search algorithm is: 


1. Fetch a word at the current address. 
2. XOR (exclusive OR) the word and search object. 
3. AND the result of step 2 with the mask. 


+. If the result of step 3 is zero, type the address of 
the unmasked word and its contents. Otherwise, proceed 
to step 5. 


5. Add two to the current address. If the current address 
is greater than the upper limit, type * and return to the 
command decoder, otherwise go to step 1. 


Note that if the mask is zero, ODT will print every word between 
the limits, since a match occurs every time (i.e., the result of step 
3 


is always zero). 


. In the effective address search, ODT interprets every word in the 





search range as an instruction which is interrogated for a possible 


direct relationship to the search object. 


The algorithm for the effective address search is (where (X) 


denotes contents of X, and K denotes the search object): 


l. Fetch a word at the current address X. 


2. If (X)-K [direct reference], print contents and go to. 
step 5. l 


3. If (X)+X+2=K [indexed by PC], print contents and go to 
Step 5. 


4, If (X) is a relative branch to K, print contents. 


5. Add two to the current address. If the current 
address is greater than the upper limit, perform a 
carriage return/line feed and return to the command 
decoder; otherwise, go to step 1l. 


5.5.4 Teletype Interrupt 


Upon entering the TTY SAVE routine, the following occurs: -( 


Save the LSR status register (TKS). 
2. Clear interrupt enable and maintenance bits in the TKS. 
3. Save the TTY status register (TPS). 

Clear interrupt enable and maintenance bits in the TPS. 


To restore the TTY: 


l. Wait for completion of any I/O from ODT. 
Restore the TKS. 
Restore the TPS. 


WARNINGS 


If the TTY printer interrupt is enabled upon entry to 
the ODT break routine, the following may occur: 


l. If no output interrupt is pending when ODT is 
entered, an additional interrupt will always 
occur when ODT returns control to the user. 


2. If an output interrupt is pending upon entry, 
the expected interrupt will occur when the user 
S regains control. 


WARNINGS (cont.) 


the TTY reader (keyboard) interrupt is enabled upon 
ry to the ODT break routine, and a character is pend- 
the interrupt (as well as the character) will be 


5.6 OPERATING PROCEDURES 


ion describes assembling and loading procedures for ODT, 
restarting and reentering procedures, error recovery, and setting 


the priority level of ODT. 


5.6.1 Loading Procedures | 
ODT-11 and ODT-11X are supplied on source and binary tapes. Source 
tapes are assembled as explained in Section 5.6.3. Binary tapes of 


either version are loaded into core memory using the Absolute Loader, 





as explained in Section 6.2.2. When using ODT's binary tapes, the 
object program should be loaded prior to loading ODT, since ODT is 


Started when loaded. 


ODT-11 is loaded into core starting at location 13026, and requires 
about 533 locations of core. ODT-11X is loaded into core starting 


10 
'at location 12054, and requires about 800 words of core. 


5.6.2 Starting and Restarting 
After loading ODT into core, it is automatically started by the 
Absolute Loader.  ODT indicates its readiness to accept input by 


printing an *. 


When ODT is started at its start address, the SP register is 


set to an ODT internal stack, registers RO-R5 are left untouched, 





ana the trace trap vector is initialized. If ODT is started after 
breakpoints have been set in a program, ODT will forget about the 
breakpoints and will leave the program modified, i.e., the break- | 


point instructions will be left in the program. 


a 








There are two ways of restarting ODT: 


l. Restart at start address+2 


25 Reenter at start addresst+4 


To restart, key in the start address+2 (13030 for ODT-11 or 
12056 for ODT-11X), press LOAD ADDRess and then START. A restart 
will save the general registers, remove all the breakpoint instruc- 
tions from the user program and then forget all breakpoints, i.e., 


simulate the ;B command. 


To reenter, key in the load address+4 (13032 for ODT-11 or 
12060 for ODT-11X), press LOAD ADDRess and then START. A reenter 
will save the general registers, remove the breakpoint instructions 
from the user program, and ODT will type the BE (Bad Entry) error 
message. ODT will remember which breakpoints were set and will 
reset them on the next ;G command (;P is illegal after a Bad Entry). 


.If the program being debugged requires storage where the version of 


ODT being used is normally loaded, it is necessary to reassemble ODT 


after changing the starting location. 


The source tape of ODT is in three segments, each separated from 


the next by blank tape. The first segment contains: 


=n (standard location setting statement) 
.EOT 


where n=13026 for ODT-11 or n=12054 for ODT-11X. This statement 


tells the Assembler to start assembling at address n. To relocate 


ODT to another starting address, substitute for segment one a source 


tare consisting of: 


.-n (n is the new load address for ODT) 
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The .EOT statement tells the Assembler that this is the end of the 
segment but not the end of the program -- the Assembler will stop and 
wait for another tape to be placed in the reader. 


The second segment of tape contains the ODT source program. This 


segment is also terminated with .EOT. 
The third segment of the tape consists of the statement: 
.END O.ODT 


where .END means "end of program" and O.ODT represents the starting 
address of the program (see Section 6.2.3). 


When relocating ODT, the first segment of the source tape must 
be changed to reflect the desired load address. The third segment 
may be changed to .END without a start address. The latter will cause 
the Loader to halt upon completion of loading. 


The segmentation allows the following assembly forms: 


l.  Assemble alone but at a new address. A new segment one 
must be generated and assembled with segments two and three. 


2. Assemble immediately after the user's program to be de- 
bugged.  Assemble the tape of the user's program (ending 
with .EOT) followed by ODT's segment two and either segment. 
three or a new segment three. 


3. Assemble inside the program to be debugged. Assemble the 
first part of the user program (ending with .EOT) followed 
by ODT's second segment followed by the second part of the 
user program. 


When setting locations before assembling, it must be noted that 


immediately preceding ODT a minimum internal stack of 40, bytes is 


8 
required for the ODT-11 and 116g bytes is required for ODT-1llX. 


Additional room must be allocated for subroutine calls and possible 
interrupts while ODT is in control. Twelve bytes maximum will be used 
by ODT proper for subroutine calls and interrupts, giving a minimum 


safe stack space of 52, bytes for ODT-11 or 130, bytes for ODT-1lX. 


8 





Oncé a new binary tape of ODT has been assembled, load it using 
Normally, the 


the Absolute Loader as explained in Section 6.2.2. 
program to be debugged is loaded before ODT, since ODT will automatically 


be in control immediately after loading, unless the third segment of 


ODT's source tape was altered before assembly. As soon as the tape is 


read in, ODT will print an * on the Teletype to indicate that it is i 


ready for a command. 
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CHAPTER 6 


Loading and Dumping Core Memory 


When your PDP-11 computer is first received its core memory is completely 
deragnetized -- it "knows" absolutely nothing, not even how to receive 
paper tape input. However, the computer can accept data when toggled 
directly into core using the console switches. Since the Bootstrap Loader 
program is the very first program to be loaded, it must be toggled into 


core. 


The Bootstrap Loader (see Section 6.1) is a program which instructs 
the computer to accept and store in core data which is punched on paper 
tape in bootstrap format. The Bootstrap Loader is used to load very short 
paper tape programs of 162g l6-bit words or less -- primarily the Absolute 
Loader and Memory Dump Programs. Programs longer than 162g l6-bit words 
must be assembled into absolute binary format using the PAL-11A Assembler 
and loaded into core using the Absolute Loader. 

The Absolute Loader (see Section 6.2) is a system program which enables 
you to load into any available core memory bank data punched on paper tape 
in absolute binary format. It is used primarily to load the paper tape sys- 
tem software (excluding certain subprograms) and object programs assembled 
with PAL-11A. 


The loader programs are loaded into the upper-most area of available 
core so that they will be available for use with system and user programs. 
When writing your programs be aware that they should not use the locations 
used by the loaders without restoring their contents; otherwise, the load- 
ers will have to be reloaded since they would have been altered by your 


object program. 


Core memory dump programs (see Section 6.3) are used to print or punch 
the contents of specified areas of core. For example, when developing or 
debugging user programs it is often necessary to get a copy of the program 
or portions of core. There are two dump programs supplied in the paper 
tape software system:  DUMPTT, which prints or punches the octal representa- 
tion of all or specified portions of core, and DUMPAB, which punches all 
or specified portions of core in absolute binary format suitable for load- 


ing with the Absolute Loader. 
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The Bootstrap Loader should be loaded (toggled) into the highest core mem-. 
ory bank. The locations and corresponding instructions of the Bootstrap 


Loader are listed and explained below. 


Location Instruction 
xx7744 016701 " 
xx7746 000026 
xx7750 012702 
xx7752 000352 
xx7754 005211 
xx7756 105711 
xx7760 100376 
xx7762 116162 
xx7764 000002. ; 2 
xx7766 xx7400 
xx7770 005267 
xx72172 177756 
xx7774 000765 


xx7776 YYYYYY 


Figure 6-1.  Bootstrap Loader Instructions 
In Figure 6-1, xx represents the highest. available memory bank. For 
example, the first location of the Loader would be one of the following, 
depending on memory size, and xx in all subsequent locations would be the 
Same as the first. 


Location Memory Bank Memory Size 
017744 0 4K 
937744 — —— 1 8K. 
057744 2 12K 
077744 3 16K 
117744 4 20K 
137744 5 24K 
157744 6 28K 


Note also in Figure 6-1 that the contents of location xx7766 should reflect 


the appropriate memory bank in the same manner as the location. 


.The contents of location xx7776 (yyyyyy in the Instruction column of 


Figure 6-1) should contain the device status register address of the paper 





| i 


tape reader to be used when loading the bootstrap formatted tapes. Either 


paper tape reader may be used, and each is specified as follows: 


Teletype Paper Tape Reader =< 177560 
High-Speed Paper Tape Reader -- 177550 


6.1.1 Loading the Loader Into Core . 
With the. computer initialized for use as described in Chapter 2, toggle in 
the Bootstrap Loader as explained below. 


l. Set xx7744 in the Switch Register (SR) and press LOAD 
ADDRess (xx7744 will be displayed in the ADDRESS REGISTER. 


2. Set the first instruction, 016701, in the SR and lift 
DEPosit (016701 will be displayed in the DATA register). 


NOTE 


When DEPositing data into consecutive words, 
the DEPosit automatically increments the AD- 
DRESS REGISTER to the next word. l 


De l 


3. Set the next instruction, 000026, in the SR and lift. 
DEPosit (000026 will be displayed in the DATA register), 


4. Set the next instruction in the SR, press DEPosit, and 
continue depositing subsequent instructions (ensure 
that location xx7766 reflects the proper memory bank) 
until after 000765 has been deposited in location xx7774. 


5. Deposit the desired device status register address in 
location xx7776, the last location of the Bootstrap | 
Loader. | 


It is good programming practice to verify that all instructions are stored 
correctly. This is done by proceeding at step 6 below. 


6. Set xx7744 in the SR and press LOAD ADDRess. à 


'7. Press EXAMine (the octal instruction in location xx7744 
will be displayed in the DATA register so that it can 
be compared to the correct instruction, 016701. If 
the instruction is correct, proceed to step 8, otherwise i | 
go to step 10. i 


8. Press EXAMine (the instruction of the location displayed 
in the ADDRESS REGISTER will be displayed. in the DATA 
register; compare the DATA register contents to the in- 
struction for the displayed location. 
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9. Repeat step 8 until all instructions have been verified D | 
or go to step 10 whenever the correct instruction is not f 
displayed. 


Whenever an incorrect instruction is displayed, it can be 


corrected by performing steps 10 and 1l. 


10. With the desired location displayed in the ADDRESS REGISTER, 
set the correct instruction in the SR and lift DEPosit (the 
contents of the SR will be deposited in the displayed loca- 
tion). i 
ll. .Press EXAMine to ensure that the instruction was correctly 

stored (it will be displayed in the DATA register). 
12. Proceed at step 9 until all instructions have been 

verified. : 


The Bootstrap Loader is now loaded into core. The procedures. 
above are illustrated in the flowchart of Figure 6-2. . 


Ctnitialize ) 


er Set SR to xx7744 


Press LOAD ADDR 


WE i 


Load 


Set SR to 016701 


Lift DEP 

: Set SR to 

] Set SR to Next Correct 
: Instruction Instructio 
Lift DEP Lift DEP 


All Y 
No nstruction ar 
Deposite 
if 








» 





Figure 6-2. Loading and Verifying the 
Bootstrap Loader 
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6.1.2 Loading Bootstrap Tapes 


fl Any paper tape punched in bootstrap format is referred to as a bootstrap 
tape (see Section 6.1.3) and is loaded into core using the Bootstrap Loader. 
Bootstrap tapes begin with about two feet of special bootstrap leader code 
(ASCII code 351, not blank leader tape as is required by the Absolute Loader). 


With the Bootstrap Loader in core, the bootstrap tape will be loaded into 
core starting anywhere between location xx7400 and location xx7743, i.e., 
162, words. The paper tape input device used is that which is specified in 
location xx7776 (see Section 6.1.1.). 


Bootstrap tapes are loaded into core as explained below. 


l. Set the ENABLE/HALT switch to HALT. 


Place the bootstrap tape in the specified reader 
with the special bootstrap leader code over the 
reader sensors (under the reader station). 


3. Set the SR to xx7744 (the starting address of the 
Bootstrap Loader) and press LOAD ADDRess. 


4. Set the ENABLE/HALT switch to ENABLE. 


5. Press START. The bootstrap tape will pass through ~> 
the reader as data is being loaded into core. 


6. The bootstrap tape stops after the last frame of 
data (see Figure 6-5) has been read into core. 
The program on the bootstrap is now in core. 


The procedures above are illustrated in the flowchart of Figure 6-3. 


With Bootstrap | [Sese Fiqure 6-2 
der in Core 









Code mus e 
r sensors 


in s ified Reader 
Set SR to xx7744 
Press LOAD ADDR 


Set ENA HALT 
oO. ENAB 


Tape Reads in and 
im nd oO Data 


Figure 6-3. Loading Bootstrap Tapes Into Core 
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Should the bootstrap tape not read in immediately after depressing the 
TART switch, it would be due to any one of the following: 


. Bootstrap Loader not correctly loaded. 


i 

2. Using the wrong input device. 

3 Code 351 not directly over the reader sensors. 
4 


Bootstrap tape not properly positioned in reader. 


6.1.3 Bootstrap Loader Operation 


The Bootstrap.Loader source program is shown below. The starting address 
in the example denotes that the Loader is to be loaded into memory bank zero 


(a 4K system). 


000001 Rl1-$1 ;USED FOR THE DEVICE ADDRESS 


000002 R2=32 ;USED FOR THE LOAD ADDRESS DISPLACEMENT 
017400 LOAD=17400 ;DATA MAY BE LOADED NO LOWER 
|. ;THAN THIS - 
017744 212744 ;START ADDRESS OF THE BOOTSTRAP LOADER 
017744 016701 START: MOV DEVICE,Rl ;PICK UP DEVICE ADDRESS, 
000026 ;PLACE IN R1 
017750 012702  LOOP: MOV #.-LOAD+2,R2 ;PICK UP ADDRESS. .., 
000352 ;DISPLACEMENT 
017754 | 005211 ENABLE: INC @R1 ;ENABLE THE PAPER TAPE T 
017756 105711 WAIT: TSTB GRl READER | 
l ;WAIT UNTIL FRAME 
017760 100376 BPL WAIT ;IS AVAILABLE _ 
017762 116162 MOVB 2(R1),LOAD(R2) ;STORE FRAME READ 
000002 ;FROM TAPE IN MEMORY 
017400. — — 
017770 005267 INC LOOP+2 ;INCREMENT LOAD ADDRESS 
177756 ; DISPLACEMENT 
017774 000765  BRNCH: BR LOOP ;GO BACK AND READ MORE DATA 
017776 | 000000 DEVICE: 0 ; ADDRESS OF INPUT DEVICE 


Figure 6-4. The Bootstrap Loader Program 


The program above is a brief example of the PAL-11A Assembly Language 


which is explained in Chapter 3. 


Bootstrap tapes are coded in the following format. 


351 
. Special bootstrap leader code (at least two feet 
. in length) 
351 
XXX Load offset (see text below) 
. AAA 


CCE : Program to be loaded (up to 162, words or 344, 
frames) 

ZZZ 

301 

035 

026 

000 

302 Boot overlay code, as shown. 
025 

373 

yy . Jump offset (see text below) 
Figure 6-5. Bootstrap Tape Format 


The Bootstrap Loader starts by loading the device status register ad- 
dress into R1 and 2529 into R2. The next instruction indicates a read 
cperation in the device and the next two instructions form a loop to wait 
for the read operation to be completed. When data is encountered it is 
transferred to a location determined by the sum of the index word (xx7400) 
and the contents of R2. PN ae 

Because R2 is initially 3528: the first word is moved to location 
xx7752, and it becomes the immediate data to set R2 in the next execution 
of the loop. This immediate data is then incremented by one and the pro- 

gram branches to the beginning of the loop. 


The leader code, plus the increment, is equal in value to the data 
placed in R2 during the initialization; therefore, leader code has no ef- 
fect on the loader program. Each time leader code is read the processor 
executes the same loop and the program remains unmodified. The first code 
other than leader code, however, replaces the data to be loaded into R2 
with some other value which acts as a pointer to the program starting loca- 
tion (loading address). Subsequent bytes are read not into the location 
of the immediate data but into consecutive core locations. The program 
will thus be read in byte by byte. The INC instruction which operates on 
the data for R2 puts data bytes in sequential locations, and requires that 
the value of the leader code and the offset be one less than the value de- 


sired in R2. 


The boot overlay code will overlay the first two instructions of the 


Loader, because the last data byte is placed in the core location immedi- 
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ately preceding the Loader. The first instruction is unchanged by the over- 
lay, but the second instruction is changed to place the next byte read, jump 
offset, into the lower byte of the branch instruction. By changing the off- 
set in this branch instruction, the Loader can branch to the start of the 


loaded program or to any point within the program. 


The Bootstrap Loader is self-modifying, and the program loaded by the 
Loader restores the Loader to its original condition by restoring the con- 
tents of locations Xx7752 and xx7774 to 000352 and 000765 respectively. 


6.2 THE ABSOLUTE LOADER 


The Absolute Loader is a system program which, when in core, enables you to 
load into any core memory bank data punched on paper tape in absolute binary 
format. It is used primarily to load the paper tape system software (exclud- 
ing certain subprograms) and your object programs assembled with PAL-11A, 
The major features of the Absolute Loader include: 


l. Testing of the checksum on the input tape to assure complete, 
accurate loads. ( 


2. Starting the loaded program upon completion of loading with- 
out additional user action, as specified by the .END in the 
program just loaded. 


3. Specifying the load bias of position independent programs 
at load-time rather than at assembly time, by using the de- 
sired Loader switch register option. 


Rc sal Loading the Loader Into Core 


— — plied on punched pa tape in.bootstrap format. 
£ he Bootstrap Loader is used to load the Absolute Loader into 


core. It occupies locations xx7474 through xx7743, and its starting address 
is xx7500. The Absolute Loader program is 721g words long, and is loaded 
adjacent to the Bootstrap Loader as explained in Section 6.1.2. 


6.2.2 Loading Absolute Tapes 

Any paper tape punched in absolute binary format is referred to as an abso- 
lute tape, and is loaded into core using the Absolute Loader. When using 
the Absolute Loader, there are two types of load available: normal and 


relocated. 


A normal load occurs when the data is loaded and placed in core according 
to the load addresses on the object tape. It is specified by setting bit 0 
of the Switch Register to zero immediately before starting the load. 


There are two types of relocated loads. 


a. Loading to continue from where the loader left off 
after the previous load - 


This is used, for example, when the object program 
being loaded is contained on more than one tape. 
It is specified by setting the Switch Register to 
000001 immediately before starting the load. 





f b. Loading into a specific area of core - 


This is normally used when loading position inde- 
pendent programs. A position independent program 
is one which may be loaded and run anywhére in 
available core. The program is written using the 
position independent instruction format (see Chap-. 
ter 9). This type of load is specified by setting 
the Switch Register to the load bias and adding 

l to it (i.e., setting bit 0 to 1). 


Optional switch register settings for the three types of loads are 
listed below. 


Switch Register 


j Type of Load Bits 1-14 Bit 0 
Normal (ignored) 0 
Relocated - continue 0 l 
loading where left off 
Relocated - load in nnnnn 1 
specified area of core (specified 

address) 


The absolute tape may be loaded using either of the paper tape readers. 


The desired reađer is specified in the last word of available core memory 


(xx7776), the input device status word, as explained in Section 6.1. The 


input device status word may be changed at any time prior to loading the 


absolute tape. 


| 


With the Absolute Loader in core as explained in Section 6.1.2, abso- 


lute tapes are loaded as explained below. 


> 
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l. Set the ENABLE/HALT switch to HALT. . i 


To use an input device different from that used when 
loading the Absolute Loader, change the address of the 
device status word (in location xx7776) to reflect the 
desired device, i.e., 177560 for the Teletype reader 
or 177550 for the high-speed reader. 


2. Set the SR to xx7500 and press LOAD ADDR. | j 


3. Set the SR to reflect the desired type of load (Figure 
E-3 in Appendix E). 


4. Place the absolute tape in the proper reader with blank 
leader’ tape directly over the reader sensors. 


5. Set ENABLE/HALT to ENABLE. 


6. Press START. The absolute tape will begin passing through . j 
the reader station as data is being loaded into core. jest 


If the absolute tape does not begin passing through the reader station, . 
the Absolute Loader is not in core correctly. Therefore, reload the Loader. 
and start over at step l above. If it halts in the middle of the tape, a | 
checksum error occurred in the last block of data read in. UR 
Normally, the absolute tape will stop passing through the reader sta- 
tion when it encounters the transfer address as generated by the statement, 
.END, denoting the end of a program. If the system halts after loading, 
check that the low byte of the DATA register is zero. If so, the tape is 
correctly loaded. If not zero, a checksum error (explained later) has oc- i 
curred in the block of data just loaded, indicating that some data was not 
correctly loaded. Thus, the tape should be reloaded starting at step 1 
above. 


When loading a continuous relocated load, subsequent blocks of data 
are loaded by placing the next tape in the appropriate reader and pressing 
the CONTinue switch. 


= 


Tne Absolute Loader may be restarted at any time by starting at step l 
above. 


6.2.3 Absolute Loader Operation 

The Loader uses the eight general registers (RO-R7) and does not preserve 

or restore,their previous contents. Therefore, caution should be taken to 

restore or load these registers when. necessary after using the Loader. i 
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A block of data punched on paper tape in absolute binary format has 
the following format. 


FRAME 1 001 start frame 
2 000 null frame 
3 XXX byte count (low 8 bits) 
4 XXX byte count (high 8 bits) 
5 yyy load address (low 8 bits) 
6 YYY load address (high 8 bits) 
data is 
: placed 
: here 
222; last frame contains a block checksum 


A program on paper tape may consist of one or more blocks of data. 
Each block having a byte count (frames 3 and 4) greater than six will 
cause subsequent data to be loaded into core (starting at the address speci- 
fied in frames 5 and 6 under a normal load). The byte count is a positive 
integer containing the total number of bytes in the block, excluding the 
checksum. When the byte count of a block is equal to six the specified load 
address is checked to see whether the address is to an even or to an odd 
location. If even, the Loader will transfer control to the address speci- 
fied. Thus the loaded program will be run upon completion of loading. If 
.odd, the loader halts. 


The transfer address (TRA) may be explicitly specified in the source 
program by placing the desired address in the operand field following the 
.END statement. For example, 
.END ALPHA 

specifies the symbolic location ALPHA as the TRA, and 
. END 

causes the Loader to halt. With 
.END nnnnnn 


the Loader will also halt if the address (nnnnnn) is odd. 


The checksum is displayed in the low byte of the DATA register of the 
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computer console. Upon completion of a load, the low byte of the DATA 
register should be all zeros (unlit). Otherwise, a checksum error has 
oc6urred, indicating that the load was not correct. The checksum is the 
low-order byte of the negation of the sum of all the previous bytes in the 
block. When all bytes of a block, including the checksum, are added to- 
gether the low-order byte of the result should be zero. If not, some 

üata was lost during the load or erroneous data was picked up; the load 

was incorrect. When a checksum error is displayed, the entire program should 
‘be reloaded, as explained in the previous section. The loaders occupy core' 


memory -as illustrated below. 
xx7776 | I/O Device Word 


Bootstrap Loader 
xx7744 


Absolute Loader 
xx7474 
User and ; B 


System 
Programs 





6.3 CORE MEMORY DUMPS 


A core memory dump program is a system program which enables you to dump 
(print or punch) the contents of all or any specified portion of core memory 
onto the Teletype printer and/or punch, line printer or high-speed punch. 

. There are two dump programs available in the Paper Tape Software System: 


l.  DUMPTT, which dumps the octal representation of the 
contents of specified portions of core onto the tele- 
printer, low-speed punch, high-speed punch, or line 
printer. 


2.  DUMPAB, which dumps the absolute binary code of the 
contents of specified portions of core onto the low- 
Speed punch or high-speed punch. 


Both dump programs are supplied on punched paper tape in bootstrap and abso- 


lute binary.formats.  Tne bootstrap tapes are loaded over the Absolute 


p- 


Loader as explained in Section 6.1.3, and are used when it would be un- 
desirable to alter the contents of user storage (below the Absolute 
Loader). The absolute binary tapes are position independent and may be | 
loade3 and run anywhere in core as explained in Section 6.2.2. 

DUMPTT and DUMPAB are very similar in function, and differ primariiy 


in the type of output they produce. 


n 6.3.1 Operating Procedures 
Neither dump program will punch leader or trailer tape, but DUMPAB will 
always punch ten blank frames of tape at the start of each block of data 
dumbed. 


P 
w 


erating procedures for both dump programs follow: 


1. Select the dump program desired and place it in the 
reader specified by location xx7776 (see Section 6.1). 


2. If a bootstrap tape is selected, load it using the 
Bootstrap Loader, Section 6.1.2. When the computer 
halts go to Step 4. 


P 3. If an absolute binary tape is selected, load it using 
the Absolute Loader (Section 6.2.2), relocating as 
desired. 


Place the proper start address in the Switch Register, 
press LOAD ADDRess and START. (The start addresses 
are shown in Section 6.3.3). l 


4. When the computer halts, enter the address of the 
desired output device status register in the Switch 
Register and press CONTinue (low-speed punch and tele- 
printer=177564; high-speed punch = 177554; line 
printer = 177514). 


5. When the computer halts, enter in the Switch 
Register the address of the first byte to be dumped 
and press CONTinue. This address must be even when 
using DUMPTT. 





6. When the computer halts again enter in the Switch 
Register the address of the last byte to be dumped 
and press CONTinue. When using the low-speed punch, 
set the punch to ON before pressing CONTinue. 


7. Dumping will now proceed on the selected output device. 


8. When dumping is complete, the computer will halt. 


I$ further dumping is desired, proceed to step 5. It is not necessary 


pas 











to respecify the output device address except when changing to another 


output device. In such a case, proceed to the second paragraph of step 3 


to restart. 


If DUMPAB is being used, a transfer block must be generated as de- 
scribed below. If a tape read by the Absolute Loader does not have a 
transfer block, the loader will wait in an input loop. In such a case, 
the program may be manually initiated. However, this practice is not 
recommended, as there is no guarantee that load errors will not occur 


when the end of the tape is read. 


The transfer block is generated by performing step 5 with the trans- 
fer adáress in the Switch Register, and step 6 with the transfer address 
minus 1 in the Switch Register. If the tape is not to be self-starting, 
ian odd-numbered address must be specified in step 5 (000001, for example). 


The dump programs use all eight general registers and do not restore 
their original contents. Therefore, after a dump the general registers 
Should be loaded as necessary prior to their use by subsequent programs.. EX 


6.3.2 Output Formats 
The output from DUMPTT is in octal in the following format: 


Xxxxxxo^yyyyYY YYYYYY YYYYYY YYYYYY YYYYYY YYYYYY YYYYYY YYYYYY 


where XxXXXXX is the address of the first location printed or punched, and 
YYYYyY are words of data, the first of which starts at location xxxxxx. 
This is the format for every line of output. There will be no more than 
eight words of data per line, but there will be as many lines as are needed 


to complete the dump. 


The output from DUMPAB is in absolute binary, as explained in Section 


6.3.3 Storage Maps 
The DUMPTT program is 87 words long. When used in absolute format the 


Storage map is: 






xx7776 
xx7744 
Absolute Loader 

xx7500. 

xx7474 Loader Stack Space 
XXXXXX-256 

DUMPTT 
xxx 


Two-word Stack Space 





XXXXXX = desired load address = start address 
When used in bootstrap format the storage map is: 


xx7776 


Bootstrap Loader 
xx7744 


DUMPTT 


start 
adéress=xx7440 


xx7434 Two-word Stack Space 








The DUMPAB program is 65,, words long. When used in absolute format 
the storage map is: 





xx7776 
Bootstrap Loader 
xx7744 
Absolute Loader 
xx7500 
xx7474 Loader Stack Space | 
XXXXXX+202 


DUMPAB 


XXXXXX Two-word Stack Space 





XXXXXX = desired load address = start address 


| When used in bootstrap format the storage map is: 


xx7776 
Bootstrap Loader 
Xx7744 
DUMPAB 
start 
address-xx7500 
xx7474 Two-word Stack Space 
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CHAPTER 7 
INPUT/OUTPUT PROGRAMMING 


7:1 INTRODUCTION 


ICX, the PDP-11 Input/Output eXecutive, frees you from the details of deal- 
ina directly with the I/O devices. It also provides certain programming 
formats so that programs written for the paper tape software system may be 


used in a monito: environment later with only minor coding changes. 


IOX provides asynchronous I/O service for the following non-file- 


oriented external devices: 


. 


l. Teletype keyboard, printer, and tape reader and punch 


2. High-speed paper tape reader and punch 


For Line Printer handling, in addition to all IOX facilities, IOXLPT is 


available. 


Simple I/O requests can be made, specifying devices and data forms for 
interrupt-controlled data transfers, which can be occurring concurrently with ` 
the execution of a running user program. Multiple I/O devices may be run- 
ning single or double buffered I/O processing simultaneously. 


Real-time capability is provided by allowing user programs to be exe- 
cuted at device priority levels upon completion of a device action or data’ 


transfer. 


Communication with IOX is accomplished by IOT (Input/Output Trap) in- 
structions in the user's program. Each IOT is followed by two or three 
words consisting of one of the IOX commands and its operands. The IOX com- 


mands can be divided into two categories: 
l. those concerned with establishing necessary conditions for 
performing input and output (mainly initializations), and 


2. those concerned directly with the transfer of data. 


When transfer of data is occurring, IOX is operating at the priority 
ievel of the device. The calling program runs at its priority level, either 


concurrent with the data transfer, or sequentially. 


E: qd, 





Programming format for commands is: 


IOT 
.WORD (an address) 


.BYTE (a command code),(a slot number) 


Before using the data transfer commands, two preparatory tasks must 


-be performed: 


l. Since device specifications are made by referencing "slots" 
in IOX's Device Assignment Table (DAT) rather than devices 
themselves, the slots specified in your code must have de- 
vices assigned to them. 


fo 


The buffer, whose address is specified in your code, must 
be set up with information about the data. 


In those non-data-transfer commands where an address or slot number does 
not apply, a 0 must be used. Addresses or codes indicated can, of course, 
be specified symbolically. 


NOTES: 


1. At load time IOX loads the following interrupt and trap vec- 
tors:  Teletype keyboard, Teletype printer, high-speed reader, 
high-speed punch, illegal memory reference, and IOT. An error 
HALT is placed in location 40. j 


2. The number of words required by IOX is 63455 


words. : 


; for IOXLPT, about 72519 


3. IOX is not position-independent, but may be reassembled anywhere 
in core. As supplied, its load address is 15100; IOXLPT's load 
address is 34600. 


The following program segment illustrates a simple input-process-output se- 


quence. It includes: 


a The setting up of a single buffer 

b All necessary initializations 

c. A formatted ASCII read into the buffer 
d. A wait for completion of the read 

e. Processing of data just read 


f£. A write command from the buffer. 


RESET=2 
READ=11 
WAITR=4 
WRITE=12 


IOT 
.WORD f 
.BYTE RESET, f 


IOT 
.WORD BUFFER 


;ASSIGN IOX COMMAND CODES 


;I1OX RESET TO DO NECESSARY 
;INITIALIZATIONS INCLUDING 
;INITING SLOT 0 FOR KBD, AND 1 FOR TTY 


;TRAP TO IOX 
;SPECIFY BUFFER 


;READ FROM KBD (SLOT 0) TILL 
LINE FEED OR FORM FEED 


.BYTE READ,f 


WAIT:  IOT 
.WORD WAIT 


; TRAP TO IOX 

;BUSY RETURN ADDRESS WHILE WAITING 
;FOR KBD TO FINISH g 

.BYTE WAITR,@ ;WAIT FOR KBD (SLOT 0) TO FINISH 


(process BUFFER) 


IOT ; TRAP TO IOX 
.WORD BUFFER SSPECIPY BUFFER 
.BYTE WRITE,l ;WRITE TO TELEPRINTER (SLOT 1) 


;BUFFER SIZE IN BYTES 

;CODE FOR FORMATTED ASCII MODE 

;IOX WILL SET HERE THE NUMBER OF BYTES READ 
=.+199 ;STORAGE RESERVED FOR 100 BYTES 


BUFFER: 199 
g 


in more complex programming it is likely that more than one buffer will be 
set up for the transfer of data, so that data processing can occur concur- 
rently rather than sequentially, as here. Note too, that there are five 

IOX commands not used in this example that will help meet the requirements 


of I/O problems not as straightforward as this. 
7.1.1 Loading IOX 


IOX (IOXLPT) is supplied on source and binary tapes. Source 
tapes are assembled as described in Section 7.1.2. 
tape of IOX (IOXLPT) is loaded with the Absolute Loader and 
must be in core before the user program to which it applies. 


The binary 





When IOX is loading, the paper tape passes through the reader 
and there is no response at the terminal to indicate that 
loading is completed. 


IOXLPT is used instead of IOX if a line printer is part of 
the system. 
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Tele2 Assembling IOX 


If there is more than 4K of core available and it is desired 
to load IOX (or IOXLPT) in other than the normal location, 
IOX must be reassembled. 


-=15100 
.EOT 


appears at the beginning of the first IOX tape (PAL) and 
contains the starting address. Create a new tape containing 
the new starting address desired; be sure to allow enough room 
ror 63419 words for IOX, 72519 for IOXLPT. For example, 


.725100 
„EOT | 


Use PAL-11A as described in Chapter 3 to assemble IOX and 
substitute the new section of tape for the first part of the 


old tape (PAl). After the new section is read, insert the IOX 
tape in the reader so the read head is past the old starting 
&ddress and .EOT and type the RETURN key to read in the rest 
of the tape. 


Now read in the second tape (PA2). An EOF? 

message is output at the end of the second tape. Type the 

RETURN key and the END? message is printed. Put the tapes through 
for the second pass of the assembler. The resulting binary 

tape can be used as described in paragraph 7.1.1. 


— 


IOX (IOXLPT) can also be assembled with a user program if 
desired. The .=15100 and .EOT lines must be deleted before 


IOX is assembled with a user program. 


10X can be assembled into the program wherever desired but if 

it is the first tape read by the assembler, remove it from the 
-sacer before typing the RETURN key (after the EOF? message of the 
second tape. (IOX and IOXLPT have a .END code which would cause the 
assembly pass to end when read). Assembling a user program and 

IOX together eliminates the need to read in IOX each time 


the program is run. 


7.2 THE DEVICE ASSIGNMENT TABLE 


Use of the Device Assignment Table (DAT) serves to make your program de- 
vice-independent by allowing you to reference a slot to which a device 

nas been assigned, rather than a specific device itself. Thus, changing 
the input or output device becomes a simple matter of reassigning a dif- 


ferent device to the slot indicated in your program. 
The DAT is set up by means of the Reset and/or Init commands. The 
TOX codes for devices (listed in the description of the Init command below) 


are assigned to the slots. 


7.2.1 Reset 


IOT 
.WORD O . 
.BYTE 2,0 








This command must be the first IOX command issued by a user program. It 
clears the DAT, initializes IOX, resets all devices to their state at 


power-up, enables keyboard interrupts, and initializes (Inits) DAT slots 


0 and 1 for the keyboard and teleprinter respectively. 


Yaued. Init 


IOT 
.WORD (address of device code) 
.BYTE 1, (slot number) 


The device whose code (stored as a byte) is found at the specified address 
is associated with the specified slot (numbered in the range 0-7). The 


.. device interrupt is turned off when necessary. (The keyboard interrupt 








always remains enabled.) There is no restriction on the number of slots 


that can be Inited to the same device. 


DEVICE 
DEVICE CODE 

Teletype Keyboard (KBD) 1 
Teletype printer (TTY) 2 ~ 
Low-Speed Reader (LSR) ju 
Low-Speed Punch (LSP) 4 
High-Speed Reader (HSR) 5 
High-Speed Punch .(HSP) 6 
Line Printer 

(IOXLPT only) (LPT) 10 


t 
Note that a device code is used only in the Init command. All other 


commands which reference a device, do so by means of a slot. Example: 


INIT-1 

IOT TRAP TO IOX 

.WORD HSRCOD SINIT SLOT 3 

.BYTE INIT,3 ;FOR HSR 
HSRCOD: .BYTE 5 ;HSR CODE 


7.3 BUFFER ARRANGEMENT IN DATA TRANSFER COMMANDS 


Use c? data-transfer commands (Read, Write, Real-time Read, Real-time Write) 
requires the setting up of at least one buffer. This buffer is used not 


only to store data for processing, but to hold information regarding the 
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quantity, form, and status of the data. The non-data portion of the buffer 
is called the buffer header, and precedes the data portion. In data trans- 
fer commands, it is the address of the first word of the buffer header that 


is specified in the word following the IOT of the command. 


NOTE 





IOX uses the buffer header while transferring 
data. The user's program must not change or 
reference it. 


The buffer format is: 





Location Contents 
Buffer Maximum number of data bytes (unsigned integer) 
BUFFER Buffer+2 Mode of data (byte) 
HEADER 
Buffer+3 Status of data (byte) 
Buffer+4 Number of data bytes involved in transfer (un- 


signed integer) 
Buffer+é Actual data begins here 


BUFFER SIZE (in Bytes 
STATUS MODE 
BYTE COUNT 








:7.3.1 -Buffer Size 


The first word of the buffer contains the size (in bytes) of the data por- 
tion of the buffer as specified by the user. IOX will not store more than 
this many data bytes on input. Buffer size has no meaning on output. K 
? 
7.3.2 Mode Byte : 
The low-order byte of the second word holds information concerning the mode 


of transfer. A choice of four modes exists: 
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Coded as 

‘a. Formatted ASCII 0 (or 200 to suppress echo) 
b. Formatted Binary L 

c. Unformatted ASCII 2 (or 202 to suppress echo) 
d. Unformatted Binary 3 


The term echo applies only to the KBD. Data transfers from other devices 


never involve an echo. 









MODE BYTE 
Bits 7 6 5 4 0 
ja: Unfor- 
matted | Binary 
Q= 


z iera 
ted ASCII 


7.3.3 Status Byte 


— 


The high-order byte of the second word of the buffer header contains infor- ( Li 


mation set by IOX on the status of the data transfer: 
MÀ 


Bits 0-4 contain the non-fatal error codes (coded octally) 


Bit § 1 = End-Of-File has occurred (attempt at reading 
data after an End-Of-Medium) 
Bit 6 1 = End-of-Medium has occurred (see Section 7.3.3.3) 
Bit 7 1 = Done (Data Transfer complete) 
STATUS BYTE 
7 6 5 4 3 2 1 0 








SEE CODES 





OM 


NON-FATAL ERRORS 


7.3.3.1 Non-Fatal Error Codes 


H 


28 checksum error 


t 


38 truncation of a long line 


R 


4, an improper mode 
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a. A checksum error can occur only on a Formatted Binary read 
(see Section 7.4.3). 

b. Truncation of a long line can occur on either a Formatted 
Binary or Formatted ASCII read (Section 7.4.1). This error 
occurs when the binary block or ASCII line is bigger than 
the buffer size specified in the buffer header. .In both 
cases, IOX continues reading characters into the iast byte 
in the buffer until the end of the binary block or ASCII 
line is encountered. 


C. An improper mode can occur only on a Formatted Binary read. 
Such occurrence means that the first non-null character 
encountered was not the proper starting character for a 
Formatted Binary block (see Section 7.4.3) 


T3932. Done Bit 


When the data transfer to or from the buffer is complete, the Done Bit is k 
a i 


“um 


set by IOX. . pst 


7.3.3.3 End-Of-Medium Bit 


The following conditions cause the EOM bit to be set in the buffer Status 
byte associated with a data transfer command. An EOM occurrence also sets 
the Done Bit. ` 


HSR HSP LSR LPT 

No tape No tape Timeout No paper 

Off line No power oo No power 

No power Printer drum gate open 


Overtemperature condition 


An End-Of-Medium condition on an output device is cleared by a manual 
operation such as putting a tape in the high-speed punch.  IOX does not re- 
tain any record of an EOM on an output device. However, an EOM on an input 
device is recorded by IOX so that succeeding attempts to read from that đe- 
vice will cause an End-Of-File (see Section 7.3.3.4). To reenable input 
the device must be manually readied and a Seek command (Section 7.6) execu- 


ted on the proper slot. The Init and Reset commands will also clear the 


EOM condition for the device. 








See Section 7.5.3 for information on detection of conditions causing 


LSR timeouts. 


When an End-Of-Medium has occurred on a Read, there may be data in the 
buffer. If an EOM has occurred on a Write, there is no way of knowing how 


much of the puffer was written. 


7.3.3.4  End-Of-File Bit 


An EOF condition appears in the Status byte if an attempt to read is made 
after an EOM has occurred.  EOF cannot occur on output. .When an EOF has oc- 


curred, no data is available in the buffer. 


7.3.4 Byte Count 


The third word contains the Byte Count: 


Zuput: In unformatted data modes, IOX reads as many data bytes 
as the user has specified. In formatted modes, IOX in- 
serts here the number of data bytes available in the buf- 
fer. In all modes, if an EOM occurs, IOX will set the 
Byte Count equal to the number of bytes actually read. 

If an EOF occurs, Byte Count will be set to 0. 


Output: Byte Count determines the number of bytes output, for 
ES all modes. An HSP end-of-tape or LPT out-of-paper con- 
dition will also terminate output, and EOM will be set 


in the Status byte.  IOX does not modify the Byte Count 
on output. 


7.4  MODES 


7.4.1 Formatted ASCII 


A Formatted ASCII read transfers 7-bit characters (bit 8 will be zero) 
until a line feed or form feed is read. IOX sets the Byte Count word in 
the buffer header to indicate the number of characters in the buffer. If 
the line is too long, characters are read and overlaid into the last byte 
of the buffer until an end-of-line (a line feed or form feed) or EOM is 
detected. Thus, if there is no error, the buffer will always contain a 


line feed cr form feed. 


A Formatted ASCII write transfers the number of 7-bit characters 
i 


specified by the buffer Byte Count. Bit 8 will always be output as zero. 
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Device-Dependent Functions 


Keyboard 
Seven-bit characters read from the keyboard are entered in the buffer and 


are echoed on the teleprinter except as follows: 


Null - Ignored. This character is not echoed or 
transferred to the buffer. 
Tab - Echoes as spaces up to the next tab stop. 
n" " : 
(CTRL/TAB Stops are located at every 8th carriage 
position. 
keys) 
RUBOUT - Deletes the previous character on the cur- 
rent line and echoes.as a backslash (N). 
If there are no characters to delete, RUBOUT 
is ignored. 
CTRL/U - Deletes the current line and echoes as +U. 
Carriage - Echoes as a carriage return followed by a 
Return line feed. Both characters enter the buffer. 


(RETURN key) 


CTRL/P - Echoes as +P and causes a jump to the restart 
address, if non-zero (see 7.6.2). 


The echo mày be suppressed by setting bit 7 of the buffer header Mode byte. 


If the buffer overflows, only the characters which fit into the buffer 
are echoed. Of course, characters which are deleted by RUBOUT or CTRL/U 
do not read into the buffer even though they are echoed. If a carriage re- 
turn causes an overflow, or is typed after an overflow has occurred, a car- 
riage return and line feed will be echoed but only the line feed will enter 
the buffer. 


In the following Formatted ASCII examples: 


a. assume there is room for five characters 
b. 4 indicates: 
in left column, the RETURN key 
in center column, the execution of a carriage return 
in right column, the. ASCII code for carriage return 
Ce ¥ indicates: 


in center column, the execution of a line feed 


in right column, the ASCII code for line feed 
q99 














fu 


RUB indicates the RUBOUT key 


OUT 
"d 
e CTRL indicates the CTRL and U keys. 
U 
Typed Echoed Entered Buffer 
ABC J ABC + ABC) + 
ABCD} ABCD y+ ABCD*: 
ABCDEF s ABCD + ABCD+ 
TE A 
ascpep BUB) 1 ABCDN )«* ABC + _ 
OUT 
CTRL RUB 3 
: 2» su) + | a+ 
pp RUB RUB \\ à 
ABCDEF Ove our a ABCD Jt AB ÀJ. 
~an RUB RUB RUB \ E 
MECDET oor opr our E” ABCD Vx) AX J+ 
Low-Speed Reader and High-Speed Reader 


ons, 


All characters are transferred to the buffer except that nulls and rubouts 


are ignored. 


Telezrinter 


Characters are printed from the buffer as they appear except that nulls are 
ignored and tabs are output as spaces up to the next tab stop. 


. Low-Speed Punch and High-Speed Punch 


Characters are punched from the buffer as they appear except that nulls are 


ignored and tabs are followed by a rubout. 


Line Printer (IOXLPT only) 


Characters are printed from the buffer as they appear except as follows: 


Nulls - Ignored 

Tab = Output as spaces up to the next tab stop. 

Carriage” = Ignored. It is assumed that a line feed or form feed 
Return follows. These characters cause the line printer "car- 


riage" to advance. 


‘All characters beyond the 80th are ignored except a line feed or form feed. 
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7.4.2 Unformatted ASCII 


Unformatted ASCII transfers the number of 7-bit characters specified by the 
header Byte Count. 





Device-Dependent Functions 


Keyboard 


Characters are read and echoed except as follows: 


Tab = Echoes as spaces up to the next tab stop. 


CTRL/P - Echoes as tP and causes a jump to the re- 
Start address, if non-zero (see 7.6.2). 


7.4.3 Formatted Binary 


Formatted Binary is used to transfer checksummed binary data (8-bit charac- 
ters) in blocks. A Formatted Binary block appears as follows: 


Byte (Octal) Meaning 
ggi - Start of block 
ggg - Always null 
XXX = Block Byte Count (low-order followed by high- 
XXX order). Count includes data and preceding 
four bytes. 
DDD 
DDD 
. = Data bytes 
DDD 
DDD 
CGC - = Checksum. Negation of the sum of all preced- 


ing bytes in the block. 


IOX creates the block on output, from the buffer and buffer header. The 
Byte Count word in the buffer header specifies the number of data bytes fol- 
| lowing, which are to be output. Note that the Byte Count output is four lar- 
ger than the header Byte Count. As the block is output, IOX calculates the 
checksum which is output following the last data byte. 
J*rI 


E 











On Formatted Binary reads, IOX ignores null characters until the first 


non-null character is read. If this character is a 001, a Formatted Binary 
block is assumed to follow and is read from the device under control of 

the Byte Count value. If the first non-null character is not 001, the read 

is immediately terminated and error code 4 is set in the Status byte. As. 

the block is read a checksum is calculated and compared to the checksum fol- 
lowing the block. If the checksum is incorrect, error code 2 is set in the 
Status byte of the buffer header. If the binary block is too large (Byte 
Count less 4, larger than the Buffer Size specified in the header), the 

last byte of the buffer is overlaid until the last data byte has been read; 


error code 3 is set in the Status byte. 


Device-Dependent Functions 
‘None. Eight-bit data characters are transferred to and from the device and. 


buffer exactly as they appear. 


7.4.4 Unformatted Binary 


This mode transfers 8-bit characters with no formatting or charaeter conver- 
Sions of any kind. For both input and output, the buffer header Byte Count: ( 
Getermines the number of characters transferred. 


Device-Dependent Functions 


None. 
7.5 DATA TRANSFERS 


7.5.1 Read 


IOT 
.WORD (address of first word of the buffer header) 
.BYTE 11, (slot number) 


This command causes IOX to read from the device associated with the 
specified slot according to the information found in the buffer header. 
IOX initiates the transfer of data, clears the Status byte, and returns con- 
trol to the calling program. If the device on the selected slot is busy, 
or a conflicting device (see Section 7.5.3) is busy, IOX retains control 
until the data transfer can be initiated. Upon completion of the Read, 
‘the appropriate bits in the Status byte are set by IOX and the Byte Count 
| word indicates the number of bytes in the data buffer. Note that use of 


TL2 


the KBD while an LSR Read is in progress will intersperse KBD characters 


into the buffer unpredictably. 


7.5.2 Write 


LOT 
.WORD (address of first word of the buffer header) 
.BYTE 12, (slot number) 


IOX writes on the device associated with the specified slot according to 
the information found in the buffer header. Transfer of data occurs in 
the amount specified by Byte Count (Buffer+4).  IOX returns control to the 
calling program as soon as the transfer has been initiated. If the device 
on the selected slot is busy, or a conflicting device is busy, IOX retains 
control until the transfer can be initiated. Upon completion of the Write, 
IOX will set the Status byte to the latest conditions. If a Write causes 
an EOM condition, the user has no way of determining how much of his buffer 
has been written (the Byte Count remains the same). 

Uh 


7.5.3 Device Conflicts in Data Transfer Commands -=~ 


Because there is a physical association between the devices on the. ASR Tele- . 
type, certain devices cannot be in use at the same time. When a data trans- 
fer command is given, IOX simultaneously checks for two conditions before . 


executing the command: 


a. Is the device requested already in use? and, - 


b. Is there some other device in use that would result in an 
operational conflict? 


IOX resolves both conflict situations by waiting until the first de- 
‘vice is no longer busy, before allowing the requested device to start func- 
tioning. (This is an automatic Waitr command. See next section.) For 
example, if the LSR is in use, and either a KBD request or a second request 
for the LSR itself is made, IOX will wait until the current LSR read has : 
been completed before returning control to the calling program. In the 
particular case of the LSR, IOX also performs a timeout check while wait- 


ing for it to become available. 


When a Read command has been issued for the LSR, IOX waits about 100 
milliseconds for each character to be read. If no character is detected 


by this time (presumably because the LSR is turned. off, or out of tape!, 
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a timeout is declared and IOX sets EOM in the appropriate buffer Status 


byte. 


The following is a table listing the devices. Corresponding to each 
device on the left is a list of devices (or the echo operation) which would 


conflict with it in operation. 


- All Possible Conflicting 
Device Devices or Operations 


KBD Echo, KBD, TTY, LSR, LSP 
TTY Echo, KBD, TTY, LSP 

LSR KBD, LSR | 

LSP Echo, KBD, TTY, LSP 

HSR HSR » 

HSP HSP 


LPT (IOXLPT only)LPT 


7.5.4  Waitr (Wait, Return) 

LOT 

-WORD (busy return address) 

-BYTE 4, (slot number) 
^Waitr, like device conflict resolution, causes IOX to test the status of 
the device associated with the specified slot. If the device (or any 
possible conflicting device) is not transferring data, control is passed 
to the instruction following the Waitr. Otherwise, IOX transfers program 
control to the busy return address. If it is desired to continuously 
test for completion of data transfer on the device, the busy return ad- 
dress of the immediately preceding IOT instruction can be specified, 
effecting a Wait loop. 


If a slot is inited to any device other than the LSR, control is 
returned to the calling program about 150 microseconds after execution 
of a Waitr. For the LSR, however, the time is about 100 milliseconds. 


Note that a not-busy return from Waitr normally means the device is 
available. However, in the case of a Write, this only means that the last 
character has been output to the device. The device is still in the process 


of printing or punching the character. Thus, care must be exercised when 


| 


p 


IZ  Krtorming an IOX Reset, hardware RESET, or HALT after a Write-Waitr se- 


quence, since these may prevent the last character from being physically 


output. 


7.5.5 waitr.vs. Testing the Buffer Done Bit 


Since IOX permits you to have device-independent code, it may not be knowr, 
from run to run, what devices will be assigned to the slots in your program. 
Waitr tests the status, not only of the device it specifies, but also of 

all possible conflicting devices. 


This means that when Waitr indicates that the device is not busy, the 
Gata transfer on the device of interest may have been dóne for some timo. 
Depending on the program and what devices are assigned to the slots for a 
given run, the Waitr could have been waiting an additional amount of time 
for a conflicting device to become free. 


Where this possibility exists and buffer availability is what is of 
interest, testing the Done bit of the Status byte (set when buffer transfer 
is complete) would be preferable to Waitr; whereas Waitr would be prefer- 


able if device availability is what is of interest. 


This distinction is made in order to write device-independent code. 
In the example below: 


a. If the devices at slots 2 and 3 could be guaranteed always 
to be conflicting, neither Waitr nor testing the Done bit 
would be necessary, because IOX would automatically wait 
for the busy device to finish before allowing the other de- 
vice to begin. 


b. If these devices could be guaranteed never to be conflicting, 
it wouldn't matter which of these methods was used, because 
Waitr couldn't be waiting extra time for a conflicting de- 
vice (of no interest) to become free. 


Example: PROGRAM A PROGRAM B 
ioT IOT 
.WORD BUF2 -WORD BUF2 
.BYTE READ, SLOT2 .BYTE READ, SLOT2 
LOS IOT 
.WORD BUF1 .WORD BUF1 
.BYTE READ, SLOT2 .BYTE READ, SLOT2 
ioT IOT 
.WORD BUF2 .-WORD BUF2 
.BYTE WRITE, SLOT3 -BYTE WRITE, SLOT3 
(cont.) 
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PROGRAM A PROGRAM B 


DUNTST:  TSTB BUF1+3 DEVTST:. IOT 
BPL DUNTST -WORD DEVTST 
.BYTE WAITR,SLOT2 


IOT 
.WORD SLOT2DEV 
.BYTE INIT, SLOT4 


Programs A and B do two successive reads from the same device into two 
Gifferent buffers. Since the devices are the same, IOX waits for the first 


read to finish before allowing the second to begin. 


In Program A, we wish to process buffer 1. To have issued a Waitr for 
the device associated with slot 2 could have meant waiting also for the. de- 
vice at slot 3 if that device were in conflict. Hence, testing the Done . 
bit in the buffer header is the proper choice. 


In program B, we wish control of the device at slot 2, so that it can 


‘be assigned to another slot and so we must know its availability. Therefore, 


Waitr is appropriate. — > 


7.5.6 Single Buffer Transfer on One Device 


A: IOT ;TRAP TO IOX 
.WORD BUF1 ;SPECIFY BUFFER 
.BYTE READ,SLOT3 ;READ FROM DEVICE AT 
;SLOT 3 INTO BUFFER 
SUSY: IOT ;TRAP TO IOX 
.WORD BUSY ;SPECIFY BUSY RETURN ADDRESS 
.BYTE WAITR,SLOT3 ;WAIT FOR DEVICE AT SLOT 


(process buffer 1) ;3 TO FINISH READING 


JMP A 


The program segment above includes a Waitr which goes to a Busy Return ad- 
dress that is its own IOT -- continuously testing the device at slot 3 for 
availability. In this instance, involving only a single device and a 
‘single buffer, a Done condition in the Buffer 1 Status byte can be inferred 
from the availability of the device at slot 3. This knowledge assures us 
that all data requested for Buffer 1 is available for processing. 


Testing the Done Bit of Buffer 1 might have been used instead, but was 


not necessary with only one device operating. Moreover, a Waitr, unlike a 


Se 


P hte: 


IL AN S ose 


Done Bit test, would detect a timeout on the LSR if that device happened 
to be associated with slot 3. 


7.5.7. Double Buffering 
IOT | ;TRAP TO IOX 


.WORD BUFl1 ;SPECIFY BUFFER 1 
.BYTE READ,SLOT3 ;READ FROM DEVICE AT 
;SLOT 3 INTO BUFFER 1 
A: TOT ; TRAP TO IOX 
.WORD BUF2 ; SPECIFY BUFFER 2 
.BYTE READ,SLOT3 ;READ FROM DEVICE AT SLOT 


;3 INTO BUFFER 2 
(process BUF1 concurrent with Read into BUF2) 


B: IOT ;TRAP TO IOX 
.WORD BUFI ;SPECIFY BUFFER 1 
.BYTE READ,SLOT3 ;READ FROM DEVICE AT 


;SLOT 3 INTO BUFFER 1 
(process BUF2 concurrent with Read into BUF1) 
JMP A 


The example above illustrates a time-saving double-buffer scheme whereby data 
is processed in Buffer 1 at the same time as new data is being read into Buf- 
fer 2; and, sequentially, data is processed in Buffer 2 at the same time as 
new data is being read into Buffer 1. 

Because IOX ensures that the requested device is free before initiating 
the command, the subsequent return of control from the IOT at A implies that 
the read prior to A is complete; that is, that buffer 1 is available for 
processing. Similarly, the return of control from the IOT at B implies that 
buffer 2 is available. Waitr's are not required because IOX has automatic- 


ally ensured the device's availability before initiating each Read. 


7.5.8  Readr (Real-time Read) 


IOT 

.WORD (address of first word of the buffer header) 
.BYTE 13,(slot number) 

.WORD (done-address) 


The Readr command functions as the Read except that upon completion of the 
data transfer, program control goes to the specified Done-address at the 
priority level of the device. Readr is used when you wish to execute a seg- 


ment of your program immediately upon completing the data transfer.  IOX 


goes*to the Done address by executing a JSR R7, Done-address. 
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The general registers, which were saved when the last character in- 


terrupt occurred, are on the SP stack in the order indicated below: 


(SP)> Return address to IOX 
R5 
R4 


Return to IOX is accomplished by an RTS R7 instruction. IOX will then re- 
store all registers and return to the interrupted program.. Care should be 
taken in initiating another data transfer if the specified device can con- 
flict with device requests at other priority levels. Waitr cannot be used 


to resolve conflict situations between priority levels. 


7.5.9 Writr (Real-time Write) 


LOY 

.WORD (address of first word of the buffer header) 
.BYTE 14, (slot number of device) PI 
.WORD (done address) 


The Writr command functions as the Write except that, upon completion 

“of the data transfer, program control goes to the specified Done-address at 
"the priority level of the device.  IOX goes to the Done-address by executing 
a JSR R7,Done-address. The condition of the general registers and the re- 
turn to IOX are the same as for Readr. Writr is used when you wish to exe- 


cute a segment of your program immediately upon completing the data trans- 


fer. 
As in the Readr, care should be taken in initiating another data trans- 
fer if the specified device can conflict with device requests at the prior- 


ity level of the calling program. 


7.6 REENABLING THE READER AND RESTARTING 


The Seek command clears IOX's internal End-Of-Medium (EOM) indicator 
on the LSR or HSR, making possible a subsequent read on those devices. 
With no EOM, an EOF cannot occur. The device associated with the specified 


slot remains Inited. 


7.6.2 Restart 


IOT 
.WORD (address to restart) 
BYTES. 3,0 


This command designates an address at which to restart your program. After 
this command has been issued, typing CTRL/P on the KBD will transfer pro - 
gram control to the restart address, providing there is no LSR read in pro- 
gress. In such a case, the LSR must be turned off (causing a timeout) be- 
fore typing a CTRL/P. If the Restart address is designated as 0, the CTRL/P 
Restart capability is disabled. 


The Restart command does not cancel any I/O in progress. It is the pro- 
gram's responsibility in its restart routine to clean up any I/O by exe- 
cuting a RESET command and ensuring that the stack pointer is. yeset. 

7.7 FATAL ERRORS 


Fatal errors result in program termination and a jump to location 409 
(loaded with a HALT by IOX), with RO set to the error code and Rl set as 


follows: 


If the fatal error was due to an illegal memory reference (code 0), 
Rl will contain the PC at the time of the error. 


If the fatal error was due to an error coded in the range 1-5, Rl 
will point to some element in the IOT argument list or to the in- 
struction following the argument list, depending on whether IOX has 
finished decoding the arguments when it detects the error. 


Fatal Error Code Reason 
0 Illegal Memory Reference, SP overflow, illegal 
instruction 
1 j Illegal IOX command 
2 Slot out of range 
3 Device out of range 
4 Slot not inited 
5 Illegal data mode 
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Note that the SP stack contains the value of the registers at the time of 


the error, namely 


(SP)^ R5 
R4 
R3 
R2 
R1 
RO 
PG 
Processor Status (PS) 


(See Section 7.3.3.1 for a discussion of non-fatal errors.) 


7.8 EXAMPLE OF PROGRAM USING IOX 


This program is used to duplicate paper tape. Note that it could be altered 
by changing the device code at RDEV or PDEV. For instance, the-program 
could easily be made to list a tape.- ( 


R0=3%0 

Rl=%} 

R2=%2 

R3=%3 

R4=34 

R6=36 

“KSLOT=0 

TSLOT=1 

RSLOT=3 

PSLOT=4 

RESET=2 

RESTRT=3 

INIT-1 

WAITR-4 

--READ=11 

WRITE=12 

EOF=20000 

CR=15 ;CR ASSIGNED ASCII CODE FOR CARRIAGE RETURN 
LF=12 ;LF ASSIGNED ASCII CODE FOR LINE FEED 


-=1000 

MSGI: 0 ; CANNED MESSAGE 
0 . ; FORMATTED ASCII 

.MSGlBC: ENDl-MSG1IBC-2 ; BYTE COUNT 

l . BYTE CR,LF i 

.ASCII / PLACE TAPE IN READER/ 
BYTE CR,LF 
«ASCII / STRIKE CR WHEN READY/ 

END1:- .EVEN 
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3UF3: Word 2 ;BUFFER SIZE 
0 ;FORMATTED ASCII MODE 
0 7BC 
0 SCR LF 
RDEV: 5 ;DEVICE CODE FOR HSR 
PDEV: 6 ;DEVICE CODE FOR HSP 
BUFL: 100 . ;BUFFER SIZE 
3 ;CODE FOR UNFORMATTED BINARY 
100 ;SPECIFIES NUMBER OF BYTES FOR TRANSFER 
_ .=.+100 ;RESERVES STORAGE FOR DATA 
3UF2: 100 ;BUFFER SIZE 
3 ;CODE FOR UNFORMATTED BINARY 
100 ;SPECIFIES NUMBER OF BYTES FOR TRANSFER 
.=.+100 ;RESERVES STORAGE FOR DATA 
BEGIN: MOV #500,R6 ; SPECIFY ADDRESS FOR BOTTOM OF STACK 
IOT : 
0 
.BYTE RESET,0 ; INITIALIZATION 
IOT 
BEGIN ; "BEGIN" SPECIFIED AS RESTART 
.BYTE RESTRT,0 ; ADDRESS FOR CTRL P 
MOV #100,BUF1+4 ;SET UP INITIAL BC ON BUF1 
MOV #100, BUF2+4 ;SET UP INITIAL BC ON BUF2__ 
IOT ;TYPE OUT DIRECTIONS 
MSG1 
.BYTE WRITE,TSLOT 
IOT ;READ A CR,LF 
BUF3 
.BYTE  READ,KSLOT 
A: IOT ;WAIT FOR HIM TO TYPE A CARRIAGE RETURN, 
;LINE FEED 
A 
.BYTE  WAITR,KSLOT 
IOT ;INIT READER 
RDEV 
.BYTE  INIT,RSLOT 
IOT ;INIT PUNCH 
PDEV 
.BYTE  INIT,PSLOT 
IOT ;START FIRST READ 
BUF1 
.BYTE  READ,RSLOT 
LOOP: IOT ;READ INTO 2ND BUFFER 
BUF2 


.BYTE | READ,RSLOT 








BIT #EOF BUF1+2 
BNE BEGIN 


IOT 

BUF1 

.BYTE WRITE,PSLOT 
C IOT 

e 

.BYTE WAITR,PSLOT 

IOT 

BUFL 

-BYTE READ,RSLOT 

BIT #EOF ,BUF2+2 

BNE BEGIN 

IOT 

BUF2 

.BYTE WRITE,PSLOT 
B: IOT 

B 

.BYTE WAITR,PSLOT 

BR LOOP 


. END BEGIN 


;END OF FILE? 
; YES 
;NO 


;WRITE OUT THIS BUFFER 


;WAIT TILL DEVICE HAS FINISHED 


;READ INTO 1ST BUFFER 


;END OF FILE? 


;WRITE OUT BUFFER 2 


;WAIT TILL DEVICE HAS FINISHED 


7.9  1OX INTERNAL INFORMATION 


7.9.1 Conflict Byte/Word 
The IOX Conflict byte (in IOX 


or free) of all devices as we 


-Bit 0 is the echo bit, bits l- 


ing codes for devices: 


lr 


LPT, Conflict Word) contains the status (busy 
ll as whether or not an echo is in progress. 
6 (and 8 in IOXLPT) refer to the correspond- 


Bit is Set 


Bit i 
Device 
Bit 2 
Device 
Bit 3 
Device 


Device} 


Bit 
| Device 


= Echo in progress 


= KBD busy 
= TTY busy 
= LSR busy 
= LSP busy 


= HSR busy 
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If Bit is Set 


Bit E 

i SIM 6 - HSP busy 
Bit 8 
P 10g = LPT busy 


In IOXLPT, the Conflict 
the line printer, there 


Byte is expanded to a word in order to accommodate 
being no bit 8 to correspond with that device's 


code of 10, (the lowest available code for. an output device - see Section 
Ta IE ee 
All Possible Confiiot 

Device Conflicting Devices Number 
KBD Echo, KBD, TTY, LSR, LSP 37 
AY Echo, KBD, TTY, LSP 27 
LSR KBD, LSR 12 
LSP Echo, KBD, TTY, LSP 23. 
HSR HSR aa, 40 
HSP HSP 100 
LPT LPT 400 


For each of the devices in the left hand column, all the possible con- 


flicts are listed along with their respective conflict numbers. These numbers, 


representing bit patterns of the devices listed in column two above, are used 
to resolve any conflicting requests for devices. The appropriate number is 
masked with the conflict byte. 


and the device being tested has its bit set allowing data transfer to begin. 


If the result is zero, there are no conflicts 


7.9.2 Device Interrupt Table (DIT) 


Each device interrupt handler has associated with it a Device Interrupt Table 
(DIT) containing information that the handler. needs: 


DIT Checksum 

DIT+2 Byte size from buffer header 

DIT+4 Address of Mode byte in buffer header 
DIT+6 Byte Location Pointer 

DIT+10 Byte Count 





DIT+12 Device code 
DIT+14 Real time done-address 


DIT+16 Address of device's data buffer register 


The device interrupt routines gain access to the proper data by means of 
the DIT entry. When a transfer is complete, they set the appropriate bits 


in the buffer header pointed to by the DIT contents. 


7.9.3 Device Status Table (DST) 

The Device Status Table (DST) is used by IOX to check for EOF conditions. 
This table contains a word for each device indicating an EOM condition with 
a l. When an EOM condition is recognized on input, IOX not only sets the 
appropriate bit in the buffer status byte associated with the data transfer, 
it also records this occurrence in the DST. When a data transfer command 
as given, IOX checks the DST for the EOM condition. If the appropriate 
word has a value of l, IOX sets EOF in the Status byte of the current- 
tommand buffer. Since EOF is only possible for the LSR (code 3), and HSR 
(code 5), the words corresponding to those devices are the only ones that 


can ever be set to 1l. 


7.9.4 Teletype Hardware Tab Facility 
1f the Teletype model has a hardware tab facility, teleprinter output can 
be speeded up by: 


l. For IOX, deleting the code from I.TTYCK+6 through I.TAB343. 


2. For IOXLPT, skipping the code from I.IOLF through I.TAB3+3 
(for the teleprinter only - not the line printer). 


7.9.5 Adding Devices to IOX 


In order to add a device to IOX the following tasks must be done: 


a. Assign a legal code to the device 
b. Modify the IOX tables 
C. Provide an interrupt routine to handle data for the device. 


The line printer (in IOXLPT) will be used as an example throughout this dis- 


cussion. 
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7.9.5.1 Device Codes 








The numbers from 7 to 17, are available for new-device codes, with the 
exception of 10, in the IOXLPT version. This code has been assigned to 
the line printer. The device code must be odd for an input device and 
even for an output device. This. is so a check can be made for com- 

mand/device correspondence; i.e., for a Read from an input device or a 


Write to an output device. 


If the newest device was assigned a number that is higher than the 
codes of all the other devices, I.MAXDEV must be redefined to that value. 
This is so an out-of-range device specification in an Init commanZ 
Can be detected. In IOXLPT, I.MAXDEV-10. 


Since each device code functions as an index in several word tables, 
the entries relating to a given device must be placed at the same relative : 
position in each appropriate table. That is, the code number must indicate . 
how many words into the table the entry for that device will be found. 

This, of course, means accounting for any unused space preceding the entry, 
if the codes are not assigned in strict sequence. Table entries for the. 
line printer are found at the 10,th word past the table tag, i.e.,. at 
Table-20. 


7.9.5.2 Table Modification 


a. I.FUNC - Each entry is the octal value of the bit pattern in 
the device Control/Status Register that enables the correspond- 
ing device and/or any interrupt facility it has. Bit setting 
this number into the device's Control/Status register turns 
the device on; bit clearing turns it off. Determine this value 
for the device to be added, and place the entry in the approp- 
riate device position in the table. For example, the line printer 
Control/Status Register has an Interrupt Enable facility in bit 
6. This pattern of 100 is the LPT entry, and is located at 
I.FUNC+20. 


b. I.SCRTAB - This table contains the addresses of the. device 
Control/Status registers. The line printer entry I.LPTSCR has 
the value 177514, and is located at I.SCRTAB+20. 






































| C. 


I.DST - (Refer to Section 7.9.3.) Create an entry of 0 for 
the device in the proper table location.  Inserting a word 
of 0 at I.DST-20 created a device status entry for the line 


printer. 


I.CONSIT - An entry in this table is used to set or clear 

a device's busy/free bit in the Conflict Byte (Conflict 

Word in IOXLPT). (See Section 7.9.1, and e. below.) Each 
value is obtained by setting one bit only - the bit number 
corresponding to the device number. The line printer, being 
device 10g, has a value of 400, (bit 10, : 
at I.CONSIT+20. 


8 set) and is .located 


In the IOX version without the line printer, entries to this table 


are found in the high-order bytes of Table I.CONFLC. One more input 


tevice entry can be added to it. In IOXLPT, however, I.CONSIT is a sepa- 


rate word table, allowing eight more devices (four input and four output) 


to be added. Byte operations in the IOX I.CONSIT became word operations 


-= œ 


in IOXLPT to adapt to this expansion. 


I.CONFLC - (Refer to Section 7.9.1 on Conflict Byte/Word.) 
Entries are bit patterns of conflicting devices. Since 


. the line printer can only conflict with itself, the I.CONFLC 


entry is equal to the I.CONSIT entry. As in the I.CONSIT 
table, byte operations were changed to word operations for 
I.CONFLC in IOXLPT. 


Create a DIT for the device (refer to Section 7.9.2) by 


.assigning a DIT label and seven words of 0. If it is an 
‘output device, the address of the Device Buffer Register 


must be added as an eighth word. 


I.INTAB - This is a table of DIT addresses. Place the 
label of the DIT (mentioned in f. above) in the correct 
position in the table. I.INTAB+20 contains the line 
printer entry I.LPTDIT. 


7.9.5.3 Interrupt Routines 


Write (and assign a label to) an interrupt routine for the device to: 


l. Get a character 

2. Check for errors by means of the device Control/Status register 
3. Do character interpretation according to the device and mode 

4. Get a character in or out of the buffer 

5. Update IOX's Byte Count 


6. Compare IOX's Byte Count to User's Byte Count and Buffer size 
specification 


7. Return for next character 


Place the label of the interrupt routine at the address of the device vector, 

and follow it with the value of the interrupt priority in bits 7, 6, and 5. 

I.LPTIR, the address of the line printer interrupt routine, is at location 
200. Location 202 contains the value 200 (indicating priority level 4). 


If the device to be added is similar to the other single-character de- 
vices, steps 3-7 above can be performed by IOX as indicated below: 


There are two routines, I.INPUT and I.OUTPUT, that are called from the 
interrupt routines. These routines mainly perform common functions for 
input and output devices. They are called as follows: 


JSR R5,I.INPUT and JSR R5,I.OUTPUT 


At the location following one of these calls is the DIT for the proper de- 
vice. The routine is thus able to use R5 to reference the DIT entries. 


I.INPUT and I.OUTPUT also contain device-dependent code to perform 
functions such as tab counters for the teleprinter and line printer, and 
deletion of carriage returns in Formatted ASCII mode for the line printer. 
The device index value is used to identify the device. For the line printer, 


a symbol I.LPT, has been assigned the value 20 for convenient reference to 


the device index. 
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CHAPTER 8 


FLOATING POINT MATH PACKAGE OVERVIEW 


The new Floating-Point Math Package, FPMP-11, is designed to 
bring the 2/4 word floating point format of the FORTRAN 
environment to the paper tape software system of the PDP-11. 
The numerical routines in FPMP-11 are the same as, those of the 
DOS-11 FORTRAN Operating Time System (OTS). TRAP and error 
handlers have been included to aid in interfacing with the 
FORTRAN routines. 


FPMP-11 provides an easy means of performing basic arithmetic 
operations such as add, subtract, multiply, divide, and compare. 
It also provides transcendental functions (SIN, COS, etc.), type 
conversions (integer to floating-point, 2-word to 4-word, etc.), 
and ASCII conversions (ASCII to 2-word floating-point, etc.). 


Floating-point notation is particularly useful for computations 
involving numerous multiply and divide operations where operand 
magnitudes may vary widely. FPMP-11 stores very large and very 
small numbers by saving only the significant digits and comput- 


ing an exponent to account for leading and trailing zeros. 


To conserve core space in a small system, FPMP-11 can be 
tailored to include only those routines needed to run a par- 


ticular user program. 


For more information on FPMP-11, refer to the FPMP-11 User's 
Manual (DEC-l11-NFPMA-A-D and to Appendix G of this manual, 
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CHAPTER 9 


PROGRAMMING TECHNIQUES 


This chapter presents various programming techniques. They 
an be used to enhance your programming and. to make optimum use 


Q 


cî the PDP-ll processor. The reader is expected to be familiar 
with the PAL-11A language (Chapter 3). 


We consider this chapter to be open-ended, i.e., we plan to 
acd more programming techniques at every subsequent printing of 
the handbook. Should you discover different techniques or can 
improve on those already included, please submit your suggestions 
for consideration using the Reader's.Comments card appended to this 


handbook or by mailing them to: 


Digital Equipment Corporation 
Software Information Services, Bldg 3-5 
146 Main Street ds. 
Maynard, Massachusetts 01754 








9,1 WRITING POSITION INDEPENDENT CODE 


When a standard program is available for different users, it often be- 
comes useful to be able to load the program into different areas of core 


and to run it there. There are several ways to do this: 


1.  Reassemble the program at the desired location. 


2. Use a relocating loader which accepts specially coded 
binary from the assembler. 


uU 


Have the program relocate itself after it is loaded. 


nos 


Write code which is position independent. 


un small machines, reassembly is often performed. When the required 
core is available, a relocating loader (usually called a linking loader) 
is preferable. It generally is not economical to have a program relocate 
itselz since hundreds or thousands of addresses may need adjustment. 
position independent code is usually not possible because of the 
struc-ure of the addressing of the object machine. However, on the PDP-11, 


position independent code (PIC) is possible. Pod 


. . PIC is achieved on the PDP-11 by using addressing modes which form 

an effective memory address relative to the Program Counter (PC). Thus, 
if an instruction and its object(s) are moved in such a way that the 
relative distance between them is not altered, the same offset relative 

to the PC can be used in all positions in memory. Thus, PIC usually 
references locations relative to the current location. PIC may make abso- 
lute references as long as the locations referenced stay in the same place 
while the PIC is relocated. For example, references to interrupt and trap 
vectors are absolute, as are references to device registers in the exter- 


nal page and direct references to the general registers. 


9.1.1 Position Independent Modes 


There are three position independent modes or forms of instructions. They 


are: 


1. Branches -- the conditional branches, as well as the unconditional 
branch, BR, are position independent since the branch address is 
computed as an offset to the PC. 


Relative Memory References -- any relative memory reference of 
the form 


w 


CLR X 
MOV X,Y 
JMP X 


is position independent because the assembler assembles it as 
an offset indexed by the PC. The offset is the difference be- 
tween the referenced location and the PC. For example, assume 
the instruction CLR 200 is at address 100: 


100/ 605067 ;FIRST WORD OF CLR 200 
102/ 000074 ;OFFSET - 200-104 


The offset is added to the PC. The PC contains 104, i.e., the 
address of the word following the offset. 


Although the form CLR X is position independent, the form 
CLR @X is not. Consider the following: 


S: CLR 2X ; CLEAR LOCATION A 


X:  .WORD A ;POINTER TO A 
A: «WORD 0 


The contents of location X are used as the address of the 
operand in the location labeled A. Thus, if all of the code 

is relocated, the contents of location X must be altered to re- 
flect the new address of A. If A, however, was the name associ- 
ated with some fixed location (e.g., trap vector, device regis- 
ter), then statements S and X would be relocated and A would . 
remain fixed. Thus, the following code is position independent. 


A = 36 ; ADDRESS OF SECOND WORD OF 
; TRAP VECTOR 
S: CLR 8X ; CLEAR LOCATION A 
X: „WORD A ;POINTER TO A 
3. Immediate Operands -- The assembler addressing form #X specifies 


immediate data, that is, the operand is in the instruction. 
Immediate data is position independent since it is a part of the 
instruction and is moved with the instruction. Immediate data 
is fetched using the PC in the autoincrement mode. 





As with direct memory references, the addressing form @#X is 

not pósition independent. As before, the final effective address 
is absolute and points to a fixed location not relative to the 
PC. 


9.1.2 Absolute Modes 


Any time a memory location or register is used as a pointer to data, the 
reference is absolute. If the referenced data is fixed in memory, inde- 


pendent of the position of the PIC (e.g., trap-interrupt vectors, device 
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registers), the absolute modes must be used.! If the data is relative to 


the PIC, the absolute modes must not be used unless the pointers involved 


are modified. The absolute modes are: 


ex Location X is a pointer 

#X The immediate word is a pointer 

(R) The register is a pointer 

(R)+ and -(R) The register is a pointer 

@(R)+ and Q-(R) The register points to a pointer 

X (R) RZ6 or 7 The base, X, modified by (R) is 
the address of the operand 

QX (R) The base, modified by (R), is a 
pointer : 


The non-deferred index modes and stack operations require a little 
clarification. As described in Sections 3.6.10 and 9.1.1, the form X(7) 
is the normal mode to reference memory and is a relative mode. Index 
mode, using a stack pointer (SP or other register) is also a relative 
mode and may be used conveniently in PIC. Basically, the stack pointer 
points to a dynamic storage area and index mode is used to access data 
relative to the pointer. The stack pointer may be initially set up by a 
position independent program as shown in Section 9.1.4.1. In any case, 
once the pointer is set up, all data on the stack is referenced relative 
to the pointer. It should also be noted that since the form O(SP) is 
considered a relative mode so is its equivalent GSP. In addition, the 
forms (SP)+ and -(SP) are required for stack pops and pushes. 


9.1.3 Writing Automatic PIC 


Automatic PIC is code which requires no alteration of addresses or point- 
ers. Thus, memory references are limited to relative modes unless the 
location referenced is fixed (trap-interrupt vectors, etc.). In addition 
to the above rules, the following must be observed: 


l. Start the program with .-0 to allow easy relocation using 
the Absolute Loader (see Chapter 6). 


2. All location setting statements must be of the form .=.+X 


or .= function of tags within the PIC. For example, .=A+10 
where A is a local label. 


when PIC is not being written, references to fixed locations may be 
performed with either the absolute or relative forms. 
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3. There must not be any absolute location setting statements. 
This means that a block of PIC cannot set up trap and/or 
interrupt vectors at load time with statements such as: 


-=34 
-WORD  TRAPH,340 ;TRAP VECTOR 


The Absolute Loader, when it is relocating PIC, relocates 
all data by the load bias (see Chapter 6). Thus, the data 
for the vector would be relocated to some other place. 
Vectors may be set at execution time (see Section 9.1.4). 


9.1.4 Writing Non-Automatic PIC 


Often it is not possible or economical to write totally automated PIC. 





In these cases, some relocation may be easily performed at execution time. 
Some of the required methods of solution are presented below. Basically, 
the methods operate by examining the PC to determine where the PIC is 
actually located. Then a relocation factor can be easily computed. In 
ali examples, it is assumed that the code is assembled at zero and has 


been relocated somewhere else by the Absolute Loader. 


9.1.4.1 Setting Up the Stack Pointer -- Often the first task of a pro- 


gram is to set the stack pointer (SP). This may be done as follows: 


-=0 ;BEG IS THE FIRST INSTRUCTION OF 
;THE PROGRAM. 
BEG: MOV PC,SP ;SP-ADR BEGt2 
TST -(SP) ;DECREMENT SP BY 2. 


7A PUSH ONTO THE STACK WILL STORE 
;THE DATA AT BEG-2. 


9.1.4.2 Setting Up a Trap or Interrupt Vector -- Assume the first word 
cf the vector is to point to location INT which is in PIC. 
X: MOV PC,RO ;RO = ADR X+2 
ADD $INT-X-2,R0 ;ADD OFFSET : 
MOV RO,@#VECT ;MOVE POINTER TO VECTOR 


The offset INT-X-2 is equivalent to INT-(X-*2) and X*2 is the value of the 
PC moved by statement X. If PCG is the PC that was assumed for the pro- 
gram when loaded at 0, and if PC. is the current real PC, then the calcula- 
tion is: 
- 4 = - 
INT PCy PC, INT+ (PC PCy) 


Thus, the relocation factor, PC-PCo, is added to the assembled value of 


INT to produce the relocated value of INT. 











9.1.4.3 Relocating Pointers -- If pointers must be used, they may be 


relocated as shown above. For example, assume a list of data is to be 


accessed with the instruction 

ADD (R0)+,R1 
The pointer to the list, list L, may be calculated at execution time as 
" follows: 


M: MOV PC,RO ; GET CURRENT PC 
ADD  £L-M-2,R0 ;ADD OFFSET 
Another variation is to gather all pointers into a table. The relo- 
cation factor may be calculated once and then applied to all pointers in 


the table in a loop. 


X: MOV PC,RO ;RELOCATE ALL ENTRIES IN PTRTBL 

SUB #X+2,R0 ;CALCULATE RELOCATION FACTOR 
MOV #PTRTBL,R1 ;GET AND RELOCATE A POINTER 
ADD  RO,Rl f" TO PTRTBL 
MOV #TBLLEN,R2 ;GET LENGTH OF TABLE 

LOOP: ADD RO,(R1)-* ; RELOCATE AN ENTRY 
DEC R2 ; COUNT 
BGE  LOOP ;BRANCH IF NOT DONE Po 


Care must be exercised when restarting a program which relocates a 
table of pointers. The restart procedure must not include the relocating 


again, i.e., the table must be relocated exactly once after each load. 


9.2 LOADING UNUSED TRAP VECTORS 


One of the features of the PDP-1l is the ability to trap on various con-. 
ditions such as illegal instructions, reserved instructions, power failure, 
etc. However, if the trap vectors are not loaded with meaningful informa- 
tion, the occurrence of any of these traps will cause unpredictable results. 
By loading the vectors as indicated below, it is possible to avoid these 
problems as well as gain meaningful information about any unexpected traps 
that occur. This technique, which makes it easy to identify the source of 
a trap, is to load each unused trap vector with: 

-=trap address 

.WORD .+2,HALT 
This will load the first word of the vector with the address of the second 


word of the vector (which contains a HALT). Thus, for example, a halt at 


i location 6 means that a trap through the vector at location 4 has occurred. 
The old PC and status may be examined by looking at the stack pointed to 


by register 6. 


The trap vectors of interest are: 


P Vector Halt At 
; Location Location Meaning 
4 6 Bus Error; Illegal Instruction; 
Stack Overflow; Nonexistent Memory; 
Nonexistent Device; Word Referenced 
at Odd Ađdress 
10 13 Reserved Instruction 
14 16 Trace Trap Instruction (000003) or 
T-bit Set in Status Word (used by ODT) 
20 22 IOT Executed (used by IOX) 
24 26 Power Failure or Restoration 
30 32 EMT Executed (used by FPP-11) 
34 36 TRAP Executed 
2.3 CODING TECHNIQUES l v 
P Because of the great flexibility in PDP-11 coding, time- and space-saving 


ways of performing operations may not be immediately apparent. Some com- 


zarisons follow. 


$.3.1 Altering Register Contents 


The techniques described in this section take advantage of the automatic 


especially in TST and CMP instructions. These instructions do not alter 


operands. However, it is important to make note of the following: 


@ These alternative ways of altering register contents 
affect the condition codes differently. 


€ Register contents must be even when stepping by 2. 
l. Adding 2 to a register might be accomplished by ADD #2,R0. 


However, this takes two words, whereas TST (RO)* which 
also adds 2 to a register, takes only one word. 


2. Subtracting 2 from a register can be done by the complemen- 
tary instructions SUB #2,RO or TST -(RO) with the same. 
conditions as in adding 2. 








3. This can be extended to adding or subtracting 2 from two 
different registers, or 4 from the same register, in one 
single-word instruction: 


CMP (RO)+,(RO)+ ;ADD 4 TO RO 

CMP -(R1),-(R1) ;SUBTRACT 4 FROM R1 

CMP (RO)+,-(R1) ;ADD 2 TO RO, SUBTRACT 2 FROM R1 
CMP -(R3),-(R1) ;SUBTRACT 2 FROM BOTH R3 AND R1 
CMP (R3)+, (RO)+ ;ADD 2 TO BOTH R3 AND RO 


4. Variations of the examples above can be employed if the in- 
structions operate on bytes and one of the registers is the 
Stack Pointer. These examples depend on the fact that the 
Stack Pointer (as well as the PC) is always autoincremented or 
autodecremented by 2, whereas registers RO-R5 step by 1 in byte 


instructions. 


CMPB (SP)+,(R3)+ ;ADD 2 TO SP AND 1 TO R3 
CMPB -—(R3),- (SP) ; SUBTRACT 1 FROM R3 AND. 2 FROM SP 
CMPB (R3)+,-(SP) ;ADD 1 vO R3, SUBTRACT 2 FROM SP 

zm Popping an unwanted word off the processor stack (adding 2 to regis- 


ter 6) and testing another value can be two separate instructions or one 


combined instruction: 


TST (SP)+ ; POP WORD 

TST COUNT ;SET CONDITION CODES FOR COUNT 
or i 

MOV COUNT, (SP)+ ;POP WORD & SET CODES FOR COUNT 


The differences are that the TST instructions take three words and clear 
the Carry bit, and the MOV instruction takes two words and doesn't affect 


the Carry bit. 


9.3.2  Subroutines 


l. : Condition codes set within a subroutine can be used to conditionally 
branch upon return to the calling program, since the RTS instruction does 


not affect condition codes. 


JSR PC,X ;CALL SUBROUTINE X 
BNE ABC ; BRANCH ON CONDITION SET 
;IN SUBROUTINE X 
Xt ;SUBROUTINE ENTRY 
CMP R2,DEF ; TEST CONDITION 
RTS PC ; RETURN TO CALLING PROGRAM 
24 When a JSR first operand register is not the PC, data stored follow- 


-ing a subroutine call can be accessed within the subroutine by referencing 


the register. (The register contains the return address.) 
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Anc-aer possibility 


PSTARG: 


SUB: 


JSR R5,Y 
.WORD HIGH 
.WORD LOW 


MOV (R5)+,R2 
MOV (R5)+,R4 


RTS R5 


is: 


JSR R5,SUB 
BR PSTARG 


.WORD A 
.WORD B 
.WORD C 


MOVB @R5, COUNT 


MOV @14(R5),R2 


MOV @6(R5),R1 


RTS R5. 


;LATEST R5 VALUE WILL POINT HERE 


; VALUE OF HIGH ACCESSED 
; VALUE OF LOW ACCESSED 


;RETURN TO LOCATION 
;CONTAINED IN R5 


; LOW-ORDER BYTE, IS OFFSET TO RETURN 

;ADDRESS, WHICH EQUALS NO. OF ARGS. 

; ADDRESS OF ARG A l 
;ADDRESS OF ARG .B 

;ADDRESS OF ARG C 


; RETURN ADDRESS 


;GET NO. OF ARGS FROM LOW BYTE 
;OF BR (IF DESIRED). 

PE.G., GET 6TH ARGUMENT 

;GET 3RD ARGUMENT 


;RETURNS TO BRANCH WHICH JUMPS PAST 
;ARG LIST TO REAL RETURN ADDRESS. 


In zhe example above, the branch instruction contributes two main 


acvantages: 


l. If R5 is unaltered when the RTS is executed, return will always 


be to the branch instruction. 


This ensures a return to the 


proper location even if the length of the argument list is 
shorter or longer than expected. 


2. The operand of the branch, being an offset past the argument 
list, provides the number of arguments in the list. 


Arguments can be made sharable by separating the data from the main 


coce. 


a subroutine itself: 


CALL: 


JSR PC,ARGLST 


This is easily accomplished by treating the JSR and its return as 


ARGLST: JSR R5,SUB 
BR PSTARG 


.WORD A 

















3. The examples above all demonstrate the calling of subroutines from 


a non-reentrant program. The called subroutine can be either reentrant 


or rcz-reentrant in each case. The following example illustrates a 


methec cf also allowing calling programs to be reentrant. The argu- 
ments and linkage are first placed on the stack, simulating a JSR R5, 


SUB, sc that arguments are accessed from the subroutine via X(R5). 


Return zo the calling program is executed from the stack. 


CALL: ; 
MOV R5,-(SP) ;SAVE R5 ON STACK. 
MOV JSBR,-(SP) ;PUSH INSTRUCTION JSR R6,@R5 ON 
;STACK. PUSH ADDRESSES OF ARGU- 
: ;MENTS ON STACK IN REVERSE ORDER 
n ; (SEE BELOW) . 
MOV BRN,- (SP) ;PUSH BRANCH INSTRUCTION ON STACK 
X: MOV SP,R5 ;MOVE ADDRESS OF BRANCH TO R5. 
JSR PC,SUB ;CALL SUB AND SAVE RETURN ON STACK. 
RET: MOV (SP)+,R5 ;RESTORE OLD R5 UPON RETURN.. 
: ;DATA AREA OF PROGRAM. 
JSBR: JSR R6,@R5 
BRN: BR .+N+N+2 ; BRANCH PAST N WORD ARGUMENTS" 


The address of an Cape can be pushed on the stack in several ways. 


Three are shown below. 


&. The arguments A, B, and C are read-only constants which are in 
memory (not on the stack): 


MOV #C,- (SP) ;PUSH ADDRESS OF C 
MOV $B,- (SP) ;PUSH ADDRESS OF B 
MOV #A,-(SP) ;PUSH ADDRESS OF A 


5. Arguments A, B, and C have their addresses on the stack at the 
Lth, Mth, and Nth bytes from the top of the stack. 


MOV N(SP),-(SP) ;PUSH ADDRESS OF C 
MOV M+2(SP),-(SP) ;PUSH ADDRESS OF B 
MOV L+4(SP),-(SP) ;PUSH ADDRESS OF A 


Note that the displacements from the top of the stack are adjusted 
by two for each previous push because the top of the stack is be- 
ing moved on each push. 


c. Arguments A, B, and C are on the stack at the Lth, Mth, and Nth 
bytes from the top but their addresses are not. 


MOV #N+2,- (SP) ;PUSH DISPLACEMENT TO ARGUMENT 


ADD SP,QSP ; CALCULATE ACTUAL ADDRESS OF C 
MOV #M+4,- (SP) 

ADD SP,@SP ;ADDRESS OF B 

MOV #L+6,- (SP) 

ADD SP,@SP ;ADDRESS OF A 


When subroutine SUB is entered, the stack appears as follows: 
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; BRANCH IS TO HERE 





Subroutine SUB returns by means of an RTS R5, which places R5 into the PC 
and pops the return address from the stack into R5. This causes the exe- 
cuticn of the branch because R5 has been loaded (at location X) with the 
address of the branch. The JSR branched to then returns control to the 
callinc program, and in so doing, moves the current PC value into the SP, 
thereby removing everything above the old R5 from tne stack. Upon return 


at 7, this too is popped, restoring the original R5 and SP values. 


The next example is a recursive subroutine (one that calls itself). 
ts function is to look for a matching right parenthesis for every left 
enthesis encountered. The subroutine is called by JSR PC,A whenever a 


eft parenthesis is encountered (R2 points to the character following it). 
a 


ECCO H A 
m 
H 


When right parenthesis is found, an RTS PC is executed, and if the right 
parenthesis is not the last legal one, another is searched for. When the 


final matching parenthesis is found, the RTS returns control to the main 


T. A: MOVB (R2)+,RO  ;GET SUCCESSIVE CHARACTERS. 
CMPB £'(,RO ;LOOK FOR LEFT PARENTHESIS. 
BNE B ; FOUND? 
JSR PC,A ;LEFT PAREN FOUND, CALL SELF. 
BRA - — ;GO LOOK AT NEXT CHARACTER | 
B: CMPB #'),RO ;LEFT PAREN NOT FOUND, LOOK FOR 
|. ;RIGHT PAREN. | 
BNE A . ;FOUND? IF NOT, GO TO A. 
RTS PC ; RETURN PAREN FOUND. IF NOT LAST, 
;GO TO B. IF LAST, GO TO MAIN PROGRAM. 
5. The example below illustrates the use of co-routines, called by 


JSR PC,2(SP)+. The program uses double buffering on both input and out- 


put, performing as follows: 


Write Ol Write O2 I 
Read Il concurrently Read I2 concurrently 
Process I2 Process Il 


JSR PC,?(SP)+ always performs a jump to the address specified on top of 
the stack and replaces that address with the new return address. Each time 
the JSP at B is executed, it jumps to a different location; initially to 


-——— 


one at'3. All other JSR's jump to B*2. 


32"IT 











PC=37 


BEGIN: (do I/O resets, inits, etc.) 

TOT. ; READ INTO Il TO START PROCESS 

.WORD I1 

.BYTE READ,INSLOT 

MOV #A,- (6) ; INITIALIZE STACK FOR FIRSY JSR 

B: JSR PC,@(6)+ ;DO I/O FOR Ol AND IL OR O2 AND I2 

Š perform processing 

BR B = ; MORE I/O 


;END OF MAIN LOOP 
;i/O CO-ROUTINES 
A: TOT ; READ INTO I2 
.WORD I2 
.BYTE READ,INSLOT 


. set parameters to process Il, Ol 


JSR PC,@(6)+ ;RETURN TO PROCESS AT Bt2 
IOT ;WRITE FROM Ol 

.WORD O1 

.BYTE WRITE,OUTSLOT 

IOT ;READ INTO Il 

.WORD I1 


.BYTE READ,INSLOT -~~ 


| è set parameters to process I2, 02 


JSR PC,@(6)+ ;RETURN TO PROCESS AT B+2 

LOT ;WRITE FROM 02 

.WORD 02 | i 
.BYTE WRITE,OUTSLOT 

BR A ;READ INTO I2 


€. The trap handler, below, simulates a two-word JSR instruction with 
.@ one-word TRAP instruction. In this example, all TRAP instructions in 
the program take an operand, and trap to the handler address at location 
34. The table of subroutine addresses (e.g., A, B, ...) can be constructed 
as follows: 

TABLE: 


CALA-.-TABLE 
.WORD A ;CALLED BY: TRAP CALA 


CALB=.-TABLE 
.WORD B ;CALLED BY: TRAP CALB 





Another way to construct the table: 


TABLE: 
CALA=.-TABLE+TRAP 
.WORD A ;CALLED BY: CALA 


The TRAP handler for either of the above methods follows: 


TRAP34: MOV @SP,2(SP) ;REPLACE STACKED PS WITH pcl. 
SUB #2,@SP ;GET POINTER TO TRAP INSTRUCTION. 
MOV @(SP)+,-(SP);REPLACE ADDRESS OF TRAP WITH 
A ; TRAP INSTRUCTION ITSELF. 
ADD #TABLE-TRAP, @SP ;CALCULATE SUBROUTINE ADDR. 
MOV @(SP)+,PC ;JUMP TO SUBROUTINE. 
In the example above, if the third instruction had been written 
MOV @(SP),(SP) it would have taken an extra word since @(SP) is in 
Index Mode and assembles as @0(SP). In the final instruction, a jump 
was executed by a MOV @(SP)+,PC because no equivalent JMP instruction 


exists. 


Following are some JMP and MOV equivalences (note that JMP does not 


affect condition codes). 


JMP (R4) 0. = MOV R4,PC 

JMP @(R4) = MOV (R4),PC 
(2 words) (1 word) 

none - MOV Q(R4),PC 

JMP - (R4) = none 

JMP @(R4)+ = MOV (R4)+,PC 

JMP Q- (R4) = MOV -(R4),PC 

none = MOV @(R4)+,PC 

none = MOV @-(R4),PC 

JMP X = MOV #X,PC 

JMP @X = MOV X,PC 

none = MOV @X,PC 





Replacing the saved PS loses the T-bit status. If a breakpoint- 
has been set on the TRAP instruction, ODT will not gain control 
again to reinsert the breakpoints because the T-bit trap will 
not occur. 








The TRAP handler can be useful, also, as a patching technique. 
Jumping out to a patch area is often difficult because a two-word 
jump must be performed. However, the one-word TRAP instruction 
may be used to dispatch to patch areas. A sufficient number of 


slots for patching should first be reserved in the dispatch table 
of the TRAP handler. The jump can then be accomplished by placing 
the address of the patch area into the table and inserting the. 
proper TRAP instruction where the patch is to be made. 


an 
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APPENDIX A 
ASCII CHARACTER SET 
NOTE 


The PTS systems punch ASCII with @ in the parity bit. 
When ASCII is read, the parity bit is ignored. 


EVEN 7-BIT 
PARITY OCTAL 
BIT CODE CHARACTER REMARKS 
g gag NUL NULL, TAPE FEED, CONTROL SHIFT P. 
sI GOL SOH START OF HEADING; ALSO SOM, START OF MESSAGE, 
CONTROL A. 
X 282 STX START OF TEXT; ALSO EOA, END OF ADDRESS, 
CONTROL B. 
g 893 ETX END OF TEXT; ALSO EOM, END OF MESSAGE, CON- .- 
TROL C. 
ae gg4 EOT END OF TRANSMISSION (END); SHUTS OFF TWX 
MACHINES, CONTROL D. i 
g g85 ENQ ENQUIRY (ENQRY); ALSO WRU, CONTROL E. 
g gg6 ACK ACKNOWLEDGE; ALSO RU, CONTROL F. 
L 987 BEL RINGS THE BELL. CONTROL G. 
1 gig BS BACKSPACE; ALSO FEO, FORMAT EFFECTOR.  BACK- 
( SPACES SOME MACHINES, CONTROL Hə 
Ø fil HT HORIZONTAL TAB. CONTROL I. 
g g12 LF. LINE FEED OR LINE SPACE (NEW LINE); ADVANCES 
PAPER TO NEXT LINE, DUPLICATED BY CONTROL J. 
1 $13 VT VERTICAL TAB (VTAB). CONTROL K. a 
Ø g14 FF FORM FEED TO TOP.OF NEXT PAGE (PAGE). CON-. 
: TROL L. 
P f15 CR CARRIAGE RETURN TO BEGINNING OF LINE. DUPLI- 
: CATED BY CONTROL M. 
i. g16 so SHIFT OUT; CHANGES RIBBON COLOR TO RED. CON- 
TROL N. 
g g17 SI SHIFT IN; CHANGES RIBBON COLOR TO BLACK. 
CONTROL O. 
1 g2g DLE DATA LINK ESCAPE. CONTROL P (DC). - 
g g21 DCI DEVICE CONTROL 1, TURNS TRANSMITTER (READER) 
ON, CONTROL Q (X ON). 
g 222 DC2 DEVICE CONTROL 2, TURNS PUNCH OR AUXILIARY 
ON.. CONTROL R (TAPE, AUX ON). 
y 923 DC3 DEVICE CONTROL 3, TURNS TRANSMITTER (READER). 
OFF, CONTROL S (X OFF). 
g f24 DC4 DEVICE CONTROL 4, TURNS PUNCH OR AUXILIARY 
OFF. CONTROL T (TAPE, AUX OFF). l 
Y 825 NAK NEGATIVE ACKNOWLEDGE; ALSO ERR, ERROR.  CON- 
TROL U. 
l $26 SYN SYNCHRONOUS IDLE (SYNC). CONTROL V. ` 
g $27 ETB END OF TRANSMISSION BLOCK; ALSO LEM, LOGICAL. 
END OF MEDIUM. ` CONTROL W. 
Ø G32 CAN CANCEL (CANCL). CONTROL X. 
1 g31 EM END OF MEDIUM. CONTROL Y. 
1 832 SUB SUBSTITUTE. CONTROL Z. 
g ;^ $33 ESC ESCAPE. PREFIX. CONTROL SHIFT K. 
1 $34 FS FILE SEPARATOR. CONTROL SHIFT L. 
A-1 


EN JeBIT 
BETY OCTAL 
T CODE CHARACTER REMARKS í 


935 GS GROUP SEPARATOR. CONTROL SHIFT M. 
236 RS RECORD SEPARATOR. CONTROL SHIFT N. 
837 US UNIT SEPARATOR. CONTROL SHIFT O. 
g4g SP SPACE. 

$41 
g42 
$43 
g44. 


Zo 


ACCENT ACUTE OR APOSTROPHE. 


R 
D 
Oo 

+ tA =m ua 


uu 
Uu un 
Ua 
pas 


/ 
g 
l 
2 
3 
4 
5 
6 
7 
8 
9 
< 
> 
? 
@ 
A 
B 
193 C 
D 
E 
F 
G 
H 
1 
J 
K 
L 
M 
N 
(e 
P 
Q 
R 
S 
T 





EVEN JeBIT 
PARITY  OCTAL 
BTT CODE CHARACTER REMARKS 


SHIFT K. 
SHIPP i 
SHIFT M. 


ACCENT GRAVE. 

THIS CODE GENERATED BY ALT MODE. 

THIS CODE GENERATED BY BS KEY (IF PRESENT) 
DELETE, RUB OUT. 


H 
C2 
N 

tw TE SHAONKM AIG 


HP RRMWQH HME RQQE d|wa 
H 
w 
D 


m 
- 
N 
Jg 
t 
E 


LOWER CASE ALPHABET FOLLOWS (TELETYPE MODEL 
37 ONLY). 


P278) ES HOC Lp I7 $3 EO«S HS pU IS. ES ET ES. R3 H 
I. 
Ul 
- 


a 
b 
c 
d 
e 
f 
g 
h 
i 
j 
k 
l 
m 

156 n 
o 
P 
q 
f 
S 
t 
u 
V 
w 
x 
Y 
Z 
| 





APPENDIX B 


PAL-11A ASSEMBLY LANGUAGE AND ASSEMBLER 


B.1 SPECIAL CHARACTERS 


Character 


form feed 
iine feed 


carriage return 


ft 


Function 


Source line terminator 
Source line terminator 
Source statement terminator 
Label terminator 

Direct assignment indicator 
Register term indicator 


Item terminator 
Field terminator 


Item terminator 
Field terminator 


Immediate expression indicator- - 
Deferred addressing indicator 
Initial register indicator 
Terminal register indicator 
Operand field separator 

Comment field indicator 
Arithmetic addition operator 
Arithmetic subtraction operator 
Logical AND operator 

Logical OR operator 

Double ASCII character indicator 
Single ASCII character indicator 


Assembly location counter 


B.2 ADDRESS MODE SYNTAX 


n is an integer between 0 and 7 representing a register. R is a register 
expression, E is an expression, ER is either a register expression or an 


expression in the range 0 to 7. 


Address Address 
Mode Mode 

Format Name Number Meaning 

R . Register On Register R contains the op- 
erand. R is a register ex- 
pression. 

@R or (ER) ‘Deferred Register In Register R contains the op- 
erand address. 

(ER) + Autoincrement 2n The contents of the regis- 
ter specified by ER are in- 
cremented after being used 
as the address of the oper- 
and. 

a (ER)-* Deferred Auto- 3n ' ER contains the pointer to 

increment the address of the operand. 
ER is incremented after use. 

- (ER) Autodecrement 4n The contents of register ER 
are decremented before being 
used as the address of the 
operand. 

i~ (ER) Deferred Auto- 5n The contents of register ER 

decrement are decremented before being 
used as the pointer to the 
address of the operand. 

A (ER) Index 6n | E plus the contents of the 
register specified, ER, is 
the address of the operand. 

GAE (ER) Deferred Index 7n E added to ER gives the point- 
er to the address of the oper- 
and. 

"E Immediate 27 E is the operand. 

#E Absolute 34 E is the address of the oper- 
and. 

Relative 67 E is the address of the oper- 
and. 
E Deferred Relative 77 E is the pointer to the ad- 


dress of the operand. 








B.3 INSTRUCTIONS 


The instructions which follow are grouped according to the operands they 
take and the bit patterns of their op-codes. l 


In the representation of op-codes, the following symbols are used: 


SS Source operand specified by a 6-bit address. 
mode. 

DD Destination operand specified by a 6-bit ad- 
dress mode. 

XX 8-bit offset to a location (branch instruc- 
tions) 

R Integer between 0 and 7 representing a general 
register. 


Symbols used in the description of instruction operations are: 


| SE Source Effective address 

| DE Destination Effective address MK: 
( ) Contents of 
cd Is transferred to 


The condition codes in the processor status word (PS) are affected by 


the instructions. These condition codes are represented as follows: 


N Negative bit: set if the result is negative 

Z Zero bit: set if the result is zero 

V oVerflow bit: set if the operation caused an overflow 
Carry bit: set if the operation caused a carry 


In the representation of the instruction's effect on the condition 


codes, the following symbols are used: 


in Conditionally set 
= Not affected 


0 Cleared 


1 Set 


To set conditionally means to use the instruction's result to deter- 
mine the state of the code (see the PDP-1l Processor Handbook. 


Logical operations are represented by the following symbols: 





1 Inclusive OR 
o Exclusive OR 
& AND 
(used over a symbol) NOT (i.e., l's complement) 


B.3.1 Double-Operand Instructions ‘Op A,A 
À Status Word 


: Condition Codes 


Op-Code MNEMONIC Stands for i Operation NW £- wc 
01SSDD MOV MOVe (SE)* DE . eto WC CONS ni s i a 
11SSDD MOVB = MOVe Byte 

028SDD ^ “CMP CoMPare (SE)-(DE) . SEES IO T 
12SSDD CMPB CoMPare Byte 

03SSDD BIT BIt Test (SE) & (DE) e ee 
13SSDD BITB BIt Test Byte 

04SSDD BIC BIt Clear (SE) &(DE)> DE o Y S 
14SSDD BICB BIt Clear Byte 

O5SSDD BIS BIt Set (SE) ! (DE) * DE Ee * 0 = 
15SSDD BISB BIt Set Byte 

06SSDD ADD ADD (SE)+(DE)> DE "s em CIN S 
16SSDD SUB SUBtract (DE)-(SE)+ DE Si EE E. 


B.3.2 Single-Operand Instructions Op A 
Status Word 


Condition Codes 


Op-Code MNEMONIC Stands for Operation BB oe 
0050DD CLR CLeaR g^ DE 0 l 0. 0 
1050DD * AGHRB CLeaR Byte 
0051DD COM COMplement (DE) DE c cw cg rug 
105iDD COMB COMplement Byte D 
0052DD INC INCrement (DE)+1> DE X. ode 9a T 
1052DD INCB INCrement Byte 
0053DD DEC DECrement (DE)~1> DE | 2 DM * - 
1053DD DECB DECrement Byte 
0054DD- NEG NEGate (DE) +1+ DE LION X 
1054DD- NEGB NEGate Byte 
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Status Word 
Condition Codes 


Op-Code MNEMONIC Stands for Operation N 2 V C 
0055DD ADC ADd Carry (DE)+(C)*+ DE tg * * * 
1055DD ADCB ADd Carry Byte 

0056DD SBC SuBtract Carry (DE)-(C)+ DE * * * * 
1056DD SBCB SuBtract Carry Byte 
0657DD TST TeST (DE)-g* DE * * 0 0 
1957DD TSTB TeST Byte 

8.3.3 Rotate/Shift Instructions Op A 


Status Word 
Condition Codes 


Op-Code MNEMONIC Stands for Operation N Z v E 
0060DD ROR ROtate Right  : s _ TN 
ch ee £9 s 
1060DD RORB ROtate Right even or odd byte ij 
Byte a aa 
0661DD ROL ROtate Left 
O&N o‘ x ox 
1061DD ROLB ROtate Left even or odd byte teehee? i 
Byte pauore dudo NN 
0062DD ASR Arithmetic oO co hh. 
| wie Mise g puo S] ros 
1062DD ASRB Arithmetic even or odd byte 
Shift Right Li "LT * 
Byte 
0063DD ASL Arithmetic 5B : 
1063DD ASLB Arithmetic even or odd byte . 
Shift Left 0 j "ERN tor Te 
eed Byte i 
0001DD JMP JuMP — DEY PC; ; ; - =. = - 
0003DD SWAB SWAp Bytes 3 rt. 
2 i EE TTS | * * 0 0 
: "E AS 


B.3.4 Operate Instructions Op 
Status Word 


Condition Codes 


Op-Code MNEMONIC Stands for Operation e WES LE d 
000000 HALT HALT The computer stops all - - - - 
functions. 

000001 WAIT WAIT The computer stops and = = - - 

and waits for an inter- 
rupt- 
000002 RTI ReTurn The PC and PS are popped * * * * 
from off the SP stack: 
Inter- 
rupt ((SP))* PC 
(SP)*2^ SP 
((SP))-^ PS 
(SP)+2> SP 
RTI is also used to re- 
turn from a trap. 
000005 RESET RESET Returns all I/O devices - = - - 
to power-on state. 
B.3.5 Trap Instructions Op or Op E where O<E<377, 
*OP (only) => 


Status Word 
Condition Codes 


Op-Code MNEMONIC Stands for Operation — Nigo ye 
*000003 (none) (breakpoint Trap to location 14. This *  * kl x 
trap) is used to call ODT. 
*000004 IOT. Input/Out- Trap to location 20. This * * * * 
put Trap is used to call IOX. 
104000- EMT EMulator Trap to location 30. This * * * * 
104377 Trap is used to call system pro- 
grams. 
104400 TRAP TRAP Trap to location 34. This * = = * 
104777 is used to call any routine 
desired by the programmer. 


CONDITION CODE OPERATES 


Ov-Code MNEMONIC 


000241 CLG 
000261 SEC 
000242 CLV 
000262 SEV 


Stands for 


CLear Carry bit in PS. 


SEt Carry bit. 
CLear oVerflow bit. 


SEt oVerflow bit. 
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Op-Code MNEMONIC Stands for 

900244 CLA CLear Zero bit. 

000264 SEZ SEt Zero bit. 

000250 CLN CLear Negative bit. 

000270 SEN SEt Negative bit. 

000254 CNZ CLear Negative and Zero bits. 

000257 ccc Clear all Condition Codes 

090277 SCC Set all Condition Codes. 

B.3.6 Branch Instructions Op E where-128, 9€ (E-:-2)/2«1271g 

Condition to be met if 

Oo-Code MNEMONIC Stands for branch is to occur 

0004XX BR BRanch always 

0010XX BNE Branch if Not Equal 2-0 
(to zero) 

0014XX BEQ Branch if EQual (to Z=1 ` 
zero) 

0020XX BGE Branch if Greater than n())v=0 
or Equal (to zero) 

0024XX BLT Branch if Less Than N (!) Vz1 
(zero) 

0030XX . BGT Branch if Greater Than z! (NQV) «0 
(zero) ; 

0034XX BLE Branch if Less than or z! (Dv) 
Equal (to zero) 

1000XX BPL Branch if PLus N=0 

1004XX BMI Branch if MInus N=1 

1010XX BHI Branch if HIgher C pas eg 

1014XX BLOS Branch if LOwer or Same (SEE S a a 

1020XX BVC Branch if oVerflow Clear =0 

1024XX BVS Branch if oVerflow Set =1 

1030XX BCC (or Branch if Carry Clear Cz0 

BHIS) (or Branch if HIgher or 

Same) 

1034XX BCS (or Branch if Carry Set (or c=1 

BLO) Branch if LOwer) 


Bs 7 


B.3.,7'* Subroutine Call Op ER, A 
Op-Code MNEMONIC Stands for 

004RDD JSR Jump to SubRoutine 
B.3.8 Subroutine Return Op ER 
Op-Code MNEMONIC Stands for 

00020R RTS ReTurn from Sub- 


routine 


B.4 ASSEMBLER DIRECTIVES 


Op-Code MNEMONIC Stands for 
.EOT End Of Tape 
. EVEN EVEN 


.END m END 
(m optional) 


Operation 


Push register on the SP stack, 
put the PC in the register: | 


DE>(TEMP) - a temporary storage 
register internal 
to processor. 

(SP)-2+ SP 

(REG) (SP) 

(PC)> REG 

(TEMP)+ PC 


Operation 


Put register contents into PC 
and pop old contents from SP 
stack into register. 


Operation 


Indicates the physical end of 
the source input medium 


Ensures that the assembly loca- 
tion counter is even by adding 
gat it is odd 


Indicates the physical and logi- 
cal end of the program and op- 
tionally specifies the entry 
point (m) 


.WORD WORD Generates words of data 
EE. s 
EB, Ey vss (the void operator) Generates words of data 
.BYTEÉ BYTE Generates bytes of data 
v m 
-—pe-pg*:)c . 
» ASCII ASCII Generates 7-bit ASCII charac- 
/XXX...X/ ters for the text enclosed by 
delimiters 
B.5 ERROR CODES 
Error Code Meaning 


A Addressing error. 
correct. 
B. Bounding error. 


An address within the instruction is in- 


Instructions or word data are being assembled 


at an odd address in memory. 
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Error Code 


D 


M 


ig 


3.6 


Loading: 


torage Re- 
quirements: 


Meaning 


Doubly-defined symbol referenced. Reference was made to a 
symbol which is defined more than once. 


Illegal character detected. Illegal characters which are 
also non-printing are replaced by a ? on the listing. 


Line buffer overflow. Extra characters (more than 7249) 
are ignored. 

Multiple definition of a label. A label was encountered 
which was equivalent (in the first six characters) to a 

previously encountered label. 


Number containing an 8 or 9 has a decimal point missing. 


Phase error. A label's definition or value varies from 
one pass to another. 


Questionable syntax. There are missing arguments or the 
instruction scan was not completed, or a carriage return 
was not followed by a line feed or form feed. 


Register-type error. An invalid use of or reference to a 
register has been made. 


Symbol-table overflow. When the quantity of user-defined 
symbols exceeds the allocated space available in the user's 
symbol table, the assembler outputs the current -source line 
with the S error code, then returns to the command string 
interpreter to await the next command string to be typed. 


Truncation error. A number was too big for the allotted 
number of bits; the leftmost bits were truncated. T error 
does not occur for the result of an expression. 


Undefined symbol. An undefined symbol was encountered 
during the evaluation of an expression. Relative to the 
expression, the undefined symbol is assigned a value of 
zero. 


INITIAL OPERATING PROCEDURES 


Use Absolute Loader (see Chapter 6). Make sure that the stari 
address of the absolute loader is in the switches when the as- 
sembler is loaded. 


PAL-11A exists in 4K and 8K versions. 


Immediately upon loading, PAL-11A will be in control and ini- 
tiate dialogue. 


Printout Inguiry 
"E What is the input device of the Source symbolic ta; 


Printout Inguiry 


XB What is the output device of the Binary cbject tape? 
IL What is the output device of the assembly Listing? - 
*T What is the output device of the symbol Table? 


Each of these questions may be answered by one of the following charac- 


Character Answer Indicated 
T Teletype keyboard 
L Low-speed reader or punch 
H High-speed reader or punch 
P. line Printer (8K version only) 


Each of these answers may be followed by other characters indicating 


'ptions: 
Option Typed Function to be Performed 
fi . on pass 1. (s 
we on pass 2 
73 on pass 3 
/E errors to be listed on'the 


Teletype on the same pass | 
(meaningful for *B or *L 
only) | 


Each answer is terminated by typing the RETURN key. A RETURN alone 


-S answer will delete the function. 


ialogue during assembly: 


Printout Response 

EOF ? Place next tape in reader and type RETURN. A 
.END statement may be forced by typing E followed 
by RETURN. 

END ? Start next pass by pacing first tape in reader 


and typing RETURN. 


EOM ? If listing on HSP or LPT, replenish tape or paper 
and type RETURN. If binary on HSP, start assembly 
again. 

Restarting: Type CTRL/P. The initial dialogue will be started 
again. 
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APPENDIX C 


TEXT EDITOR, ED-11 


INPUT/OUTPUT COMMANDS 


R 


Reads a page of text from input device, and appends it to the 
contents (if any) of the page buffer. Dot is moved to the 
beginning of the page and Marked. (See B and M below.) 


Opens the input device when the user wishes to continue input 


^ with a new tape in the reader. 


ARGUMENTS 


(n) beginning at Dot and ending with 
nth line feed character. 
ists the character 
tring (-n) beginning with lst character fol- 
lowing the (n+l)th previous line 
feed and terminating at Dot. 


(0) beginning with Ist character of 
current line and ending at Dot. 


(8) bounded by Dot and the Marked 
location (see M). 
Punches the character (/) 


string beginning at Dot and ending with 


the last character in the page. 


Outputs a Form Feed character and four inches of blank tape. 
Punches four inches of Trailer (blank tape) n times. - 


Punches contents of the page buffer (followed by a trailer if 

a form feed is present), deletes the contents of the buffer, and 
reads the next page into the page buffer. It does this n times. 
At completion, Dot and Mark are located at the beginning of the 

page buffer. 


Lists the entire line containing Dot (i.e., from previous line 
feed to next line feed or form feed. 


Same as -lL. If Dot is located at the beginning of a line, 
this simply lists the line preceding the current line. 


Lists the line following the current line. 


POINTER-POSITIONING COMMANDS 


B 


E 


M 


Moves Dot to the beginning of the page. 

Moves Dot to the end of the page. 

Marks the current position of Dot for later reference in a 
command using the argument @. Certain commands implicitly 


move Mark. 


Cad 


(n) forward past n characters 
(7n) backward past n characters 





^ à (0) to the beginning of the current line 
" ib dr (8) to the Marked iocation 
| (/) to the end of the page 
(n) forward past n ends-of-lines 
a (-n) to first character following the pore 
previous end-of-line 
| A Moves Dot: (0) to the beginning of current line 
\ (@) to the Marked location 
fy} (/) to the end of the page 
v.3 SEARCH COMMANDS 
nG Gets (searches for) the nth occurrence of the specified charac- 
XXXX ter string on the current page. Dot is set immediately after 


the last character in the found text, and the characters from 
the beginning of the line to Dot are listed on the teleprinter. 
If the search is unsuccessful, Dot will be at the end of the 
buffer and a ? will be printed out. 


H Searches the wHole file for the next occurrence of the speci- 

XXXX fied character string. Combines G and N commands. If search 
is not successful on current page, it continues on Next page. 
Dot is set immediately after the last character in the found 
text and the characters from the beginning of the line to Dot 
are listed on the teleprinter. If the Search object is not 
found, Dot will be at the end of the buffer and a ? will be 
printed out. In such a case, all text scanned is copied to 
the output tape. 


i. COMMANDS TO MODIFY THE TEXT 
Character-Oriented Line-Oriented 


nD Deletes} the following nK Kills the character string 
nC Changes] n characters nx exchanges beginnning at Dot 





XXXX XXXX and ending at the 
nth end-of-line. 
-nD Deletes the previous -nK Kills 1 the character string | 
-nC Changes n characters -nX eXchanges | beginning with the 
XXXX XXXX first character fol- 


lowing the (n*1)th 
previous end-of-line 
and ending at Dot. 


OD Deletes the current line OK Kills M the current line up 
oc Changes. up to. Dot Ox eXchanges | to Dots 
XXXX XXXX re 
8D Deletes The character @K Kills { the character string 
ec Changes ) string begin- ex exchanges | beginning at Dot and 
AXXX A ning at Dot and XXXX ending at a previ- 
ending at a pre- ously Marked loca- 
viously Marked tion. 
location. 








ut 


XXXX 





Character-Oriented Line-Oriented 


Changes 


inserts 


mand. 


SYMBOLS 


Dot 


CTRL/FORM 


causes execution of the command. 
mediately following the last character inserted. 
"inserted before the position of Mark, ED-1l performs an M com- 


ied the character /K Kills ) the character 
s 


string begin- /X eXchange 
ning at Dot and  ZXXX 
ending with the 


the specified text. LINE FEED terminates Text Mode and 
Dot is set to the location im- 
If text was 


Location following the most recent character 
Operated upon. p 


Holding down the CTRL key (not the ^ key) in 
combination with another keyboard character. 


If in command mode, it executes the current 
command; goes into Text Mode if required. 

If in Text Mode, it terminates the current 
line, enters a carriage return and line feed 
into the buffer and stays in text mode. At 
all times causes the carriage to move to the 
beginning of a new line. (RETURN is often 
symbolized as JJ). 


(Typing the LINE FEED key) Terminates Text . 
Mode unless the first character typed in Text 
Mode;  executes the current command. 


A Form feed which terminates, and thus defines, 
a page. of the user's text. 


GROUPING OF COMMANDS 


NO Arguments 


7'y td wv ^ 


Argument n only All Arguments (n,-n,0,@,/) 


(Verify: G (Get) A (Advance) 
Lists current line) N (Next) C (Change) 
(Lists previous line) T (Trailer) D (Delete) 
(Lists next line) J (Jump) 
(Begin) K (Kill) 
(End) L (List) 
(Form feed) P (Punch) 
(wHole) X . (eXchange} 
(Insert) 

(Mark) 

(Open) 

(Read) 


string begin- 
ning at Dot and 
ending with the 
last character last character 
of the page. of the page. 


n y 


Requiring Line Character 
Text Mode Oriented Oriented 

C (Change) A (Advance) J (Jump) 

G (Get) K (Kill) D (Delete) 
H (wHole) L (List) 

I (insert) P (Punch) 

X (eXchange) X (eXchange) C (Change) 


C.7 OPERATING PROCEDURES 


C.7.1 Loading: Use Absolute Binary Loader (see Chapter 5). 


Per LINES Storage Requirements: ED-11 uses all of core. 


C.7.3 Starting: Immediately upon loading, ED-11 will be in 
control. 


C.7.4 Initial Dialogue: 


Program Types User Response 
*I LJ (if LSR is to be used for source input) 
H 2 (i£ HSR is to be used for source input) 
*Q LA (if LSP is to be used for edited output) 
H2 (if HSP is to be used for edited output). 


I= the output device is the high-speed punch (HSP), Editor enters 
command mode to accept input. Otherwise the sequence continues with: 


LSP OFF? J (when LSP is off) 


Upon input of ) from the keyboard, Editor enters command mode and is ready 


C.7.5 Restarting: Type CTRL/P twice, initiating the normal 
initial dialogue. The text to be edited 
should be loaded (or reloaded) at this time. 





APPENDIX D 
DEBUGGING OBJECT PROGRAMS ON-LINE, ODT-11 AND ODT-11X 


D.l SUMMARY OF CONTENTS 





ODT indicates readiness to accept commands by typing * or by opening 


a location by printing its contents. 


l. ODT-11 
n/ l 
X 


RETURN key 


SB/ 
;P 


n;P 
$M/ 
n;W 


n;E 


n/ (con- 
tents) m;O 


$S/ 


$P/ 


opens 


word n 


reopens last word opened 


closes open location 


opens 
opens 
opens 
opens 


next location 

previous location 
relatively addressed word 
general register n (0-7) 


goes to word n and starts execution 


sets breakpoint at word n 


removes breakpoint 


opens breakpoint status word 


proceeds from breakpoint, stops again on 


encounter 


proceeds from breakpoint, stops again on 


Opens mask for word search 


searches for words which match n in bits 


in $M 


searches for words which address word n 


calculates offsets from n to m 


opens location containing user program's 


register 


opens location containing ODT's priority 


NOTE 


nth encounter 


specified 


Status 


level 


If a word is currently open, new contents for the 
word may be typed followed by any of the commands 
or +. The open word will be modified 


RETURN, t, t, 


and closed before the new command 


is executed. 


2. ,ODTellx 


In addition to the commands of the regular version, the extended 


version has the following: 


N opens byte 

X os reopens last byte opened | 
e opens the absolutely addressed word | 
» opens the word tco which the branch refers | 
< opens next location of previous sequence | 
n; rB (r between 0 and 7) sets breakpoint r at word n 

; zB removes breakpoint r 

;B removes all breakpoints 

$B/ opens breakpoint 0 status word. Successive LINE 


FEEDS open words for other breakpoints and single- 
instruction mode. 


ins enables Single-instruction mode (n can have any value 
and is not significant) ; 


KP in single-instruction mode, Proceeds with program run 
for next n instructions before reentering ODT (if 
is missing, it is assummed to be 1) 


:s disables Single-instruction mode 
D.2 OPERATING PROCEDURES 


For assembling and loading the source tapes of both ODT versions, 
see Section 5.6.3 The following describes use of the supplied 
binary tapes. E 


l. Loading 


Both ODT versions are loaded by using the Absolute Loader (see Sec- 
tion 6.2.2). ODT-11 is loaded into core starting at location 13060, 
and requires about 500 locations of core. ODT-11X is loaded into 


core starting at location 12150 and requires about 800 locations of 











2. Starting 


Each ODT version is automatically started by the Absolute Loader at 1 


its start address immediately after loading. 


3. Restarting 


There are two ways of restarting ODT: 


l. Restart at start address +2 


2. Reenter at start address +4 


To restart, key in the start address +2 (13062 for ODT-11 or 12152 
.$or ODT-11X) and press the START switch. All previously set break- 
points will be removed, registers RO-R6 will be saved, and ODT will - 
assume that the trace trap vector has been initialized. Bet 
To xeenter, key in the start address +4 (13064 for ODT-11 or 12154 
for ODT-11X) and press START. All previously set breakpoints and 


internal registers will be saved. 


APPENDIX E 


LOADING AND DUMPING CORE MEMORY 


E.l The BOOTSTRAP Loader 


l.l. Loading the Bootstrap Loader 


The Bootstrap Loader should be toggled into the highest core memory 


bank. 

xx7744 016701 
xx7746 000026 
xx7750 . 012702 
xx71752 . 000352 
xx7754 & 00521] 
xx7756 105711 
xx7760 100376 
xx7762 116162 
xx7764 000002 
xx7766 xx7400 
xx7770 005267 

n > a ke A a 177756 
xx7774 000765 —- 
xXx7776 YYYYYY : 


xx represents the highest available memory bank. For example, the first 
location of the loader would be one of the following, depending on memory 
size, and xx in all subsequent locations would be the same as the first. 


Location Memory Bank Memory Size 

. 017744 0 4K 
037744 d 8K 
057744 2 12K 
077744 3 16K 
117744 4 20K 
137744 5 24K 
157744 6 28K 


The contents of location xx7776 (yyyyyy) in the Instruction column 
‘above should contain the device status register address of the paper tape 
reader to be used when loading the bootstrap formatted tapes. specified 


as follows: 


Teletype Paper Tape Reader m 177560 
T AT MN High-speed Paper Tape Reader -- 177550 


ESI 
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Figure E-1 Loading and Verifying the Bootstrop Loader 


2. Loading with the Bootstrap Loader 


With Bootstrap Fi 1 
Loader in Core | ^ TT Me cus E 
Set ENABLE /HALT 
To HALT 


Place Bootstrap 
Tope in 
specified reader 










E oa ie» | Code 351 must be 
over reader sensors 

Set SR to xx7744 

Press LOAD ADDR 


Set ENABLE /HALT 
to ENABLE 


Press START 
























Tape Reads in 
and stops 
At end of Dota 


um | see Figure 6-5 


11-0067 


Figure E-2. Loading Bootstrap Tapes into Core 


E.2 THE ABSOLUTE LOADER 


1. Loading the Absolute Loader 


The Bootstrap Loader is used to load the Absolute Loader into core. 
(See Figure E-2.) The Absolute Loader occupies locations xx7474 through 
xXx7743,' and its starting address is xx7500. 


2. Loading with the Absolute Loader 


When using the Absolute Loader, there are three types of loads avail- 


able: normal, relocated to specific address, and continued relocation. 


Optional switch register settings for the three types of loads are 
listed below. 


Switch Register 
Type of Load Bits 1-14 |. . C Bit © 


‘Normal fignored) l 0 





Switch Register 


Type of Load Bits 1-14 Bit 0 
Relocated - continue loading 0 1 


where left off 


Relocated - load in specified nnnnn L 
area of core (specified address) 


E.3 CORE MEMORY DUMPS 


The: two dump programs are 


DUMPTT, which dumps the octal representation of the 
contents of all or specified portions of core onto 

the teleprinter, low-speed or high-spéed punch, or 

line printer. i 


DUMPAB, which dumps the absolute binary code of the 
contents of specified portions of core onto the low- 
speed (Teletype) or high-speed punch. 


Both dumps are supplied on punched paper tape in bootstrap and 
absolute binary formats. The following figure summarizes loading 
and using the Absolute binary tapes. 


Initialize 


No 





Load ABS See Fig. E-2 

LOADER B 
XP Set ENABLE/HALT to HALT HSR-1778550 (This is 
| LSR=177560 nee 


XX is HIGH- only if 
EST CORE using a 
MEMORY BANK reader 
- different 
Place tape in Reader from that 
used by 
l the 
Set SR to xx7500. Press LOAD ADDR bootstrap 


loader.) 







Set xx7776 to specify reader-r-- 


2 


Relocate to, Type Normal 
Set ait of SR of Load : 
i ifi ar Bit 
Specify ADDR in Specific ? le it 0 of SR 
bits 1 ADDR 


Continuing Relocation 


U 


thet 


i rt 






& PO 


 4—— 


heck 


Place next tape rz] 
in Reader 





Remove tape 


Figure E-3. Loading with the Absolute Loader 
5^9 








puo o0mnsmmssmRMNNNNNMNMNMNN 


EEUU E 
— 





| Initialize | 


Specify Reader 
in xx7766 










Toggle in No | Load ABS 
Boot Loader i Loader 













aN 
i 


ee 
Yes Yes 
nel 
See Fic. E-2|]-- -- Load Dump Tape Load Dump Tape EI See Fig. E-3 


Set SR to trans- 
fer address 


Press LOAD ADDR 
and START ae 





HSP 
Set SR to 177554 


Set SR to 177564 


| LSP S 
| 


oress PUNCH on 


LP 


et SR to 177514 


SSH 


[ press continue 


Dumpiz- Using DUMPAB or DUMPTT | à 


E-6 





Set SR to firs 
Byte Address 
DUMPed 


| Press CONTinue | 


| 
Set SR to last 
Byte Address 
DUMPed 














Press CONTinue 


Core is DUMPed 


No a 







An odd transfer address 
causes absolute loader 
to halt 





Press CONTinue 


Set SR to TRA- 


Press CONTinue 









TRA block is 
dumped 


Done 


Figure E-4 (continued). Dumping Using DUMPAB or DUMPTT 


E-7 
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F.1 INSTRUCTION 
1. Format: 


IOT 

.NORD ( 
.BYTE ( 
.WORD ( 


2. Command 


INIT 
RESET 
RSTRT 
WAITR 

SEEK 

READ 
WRITE 
READR 
WRITR 


F.2 PROGRAM FLOW 


1. Set up b 


APPENDIX F 


INPUT/OUTPUT PROGRAMMING, IOX 


SUMMARY 


an address) 
a command code, a slot number of a device) 
done address) ;READR AND WRITR ONLY 


Codes: 


L 
2 
= 3 
4 
5 


SUMMARY 


uffer header: 


Location Contents 
(suffer and Maximum number of data bytes (unsigned 
' Buffertl integer) 


BUFFER ; Buffer-*2 
UPADEDP 
REAUS | Buffer+3 


| Buffert+4 
Buffert5 


Buffer+6 


Mode of data (byte) 
Status of data (byte) 


and Number of data bytes involved in trans- 
fer (unsigned integer) 


Actual data begins here. 


Mode Byte Format 
Bits 7 6 5 4 3 2 1 0 Bits 


l= No Echo =1 





Coding Mode Byte 


Formatted ASCII 


0 (or 200 to suppress echo) 
Formatted Binary d 
Unformatted ASCII 2 (or 202 to suppress echo) 
Unformatted Binary 3 l 
Status Byte Format 
7 6- 5 4 3 SUN. I 0- 


SEE CODES 


NON-FATAL ERRORS 





Coding Non-Fatal Errors 


= checksum error (formatted binary) 
= truncation of a long line 


= an improper mode 


2. Assign devices to slots in Device Assignment Table: 


(RESET and INIT commands) 
Slot numbers are in the range 0 to 7. 


Device Codes: 


KBD = 1 LSP = 4 LPT = 10 
TLY = Zz HSR = 
LSR = 3 HSP = 6 


3. Use a data transfer command to initiate the transfer. 


F.3 FATAL ERRORS 


Fatal errors result in a jump to 409 with RO set to the error code. Rl 
is set to the value of the PC for error code 0. Errors 1-5 cause Rl to 


be set to an IOT argument or to the instruction following the arguments. 





Fatal Error Code Reason 
0 Illegal Memory Reference, SP overflow, illegal 
instruction 
E l 1 Illegal command 
| 2 Slot out of range 
3 Device out of range 
4 : Slot not inited 
5 Illegal data mode 
i 
j F-3 


APPENDIX G 


SUMMARY OF FLOATING POINT 
MATH PACKAGE, FPMP-11 





This appendix lists all the global entry points of FPMP-11 and 

provides a brief description of the purposes of each. Sections G.1 

and G.2 are for reference when it is desired to call FPMP-11 routines 
directly (i.e., without the use of the TRAP handler). Entry names 
preceded by an octal number can be referenced via the TRAP handler. 

The number is the "routine number" referred to in the FPMP-11 manual. 

If she number is enclosed in parentheses, the routine cannot be 

accessed by the present TRAP handler, but has been assigned a number 

for future use. For a more detailed explanation of the Floating 
Point Math Package, refer to the FPMP-11 User's Manual DEC-11-NFPMA-A-D.| 


Examples of the calling conventions are: 


POLISH MODE: : TC 
JSR R4,$POLSH ;enter Polish mode 
$subrl ;call desired subroutines 
$subr2 
$subrn ;call last subroutine desired 
. WORD .*2 ;leave Polish mode 

J5RA: s 
JSR R5,subr ;call desired subroutine 
BR XX 
.WORD argl ;subroutine argument address 


.WORD | argn ;last argument 
XX: $ ¡return point 





JPG: n 


push args onto Stack 
JSR PC,subr 






Gi OTS ROUTINES 


These are the routine taken from the FORTRAN operating time system. 


The codes used in the following table are: 


s = Routine is included in the standard single precision (2-word) 
package. 

p = Routine is included in the standard double precision (4-word) 
package. 

Sp = Routine is included in both standard packages. 


Octal codes shown in parentheses are not yet implemented. 





OCTAL & OF 
! NAME CODE PKG ARGU MODE DESCRIPTION 
| $ADD 14 D 2 Polish The double. precision add routine. 
Adds the top stack item (4-words) 
to the second item (4-words) and 
leaves the four word sum in their 
place. 

SADR 12 S 2 Polish The single precision add routine. 

Same as S$ADD except it uses 2 wor 
l numbers. 

AINT 26 S 1 J5RR Returns sign of argument * greate 
real integer = bsolute value of 
the argument in RO,Rl. 

ALOG 53 S i J5RR Calculates natural logarithm of 
single argument and returns a tw 
word result in RO,Rl. 

ALOG10 54 S 1 J5RR Same as ALOG, except calculates 

| base-10 logarithm. 
| | ATAN 42 S 1 J5RR Returns the arctangent of its 


argument in RO,Rl. 


G-2 


OCTAL # OF 


NAME CODE PKG ARGU MODE DESCRIPTION 
ATAN2 (43) S 2 J5RR Returns ARCTAN(ARG1/ARG2) in RO,Rl. 
$CMD 16 D 2 Polish Compares top 4 word items on the 


Stack, flushes the two items, and 
returns the following condition 


codes: 
4 (SP) GSP N-1,2-0 
4(SP) = GSP N-0,Z2-1 
£ 4 (SP) GSP N=0,Z=0 
SCM? Ur EE - 2 Polish Same as $CMD except it is for 2 
word arguments. | 
COS 37 S i J5RR Single precision.version of DCOS. 
DATAN 44 i J5RR Double precision version of ATAN. 
DATAN (45) D 2 J5RR Double precision version of ATAN2. 
DBLE (34) nf J5RR Returns in RO-R3 the double 


precision equivalent of the single 
precision (two word) argument. 


$DCI (57) SD 4 JPC ASCII to double conversion. 
Calling sequence: 

Push address of start of ASCII 
field. ido: 

Push length of ASCII field in 
bytes. l 
Push format scale D (from W.D) | 
position of assumed decimal | 
point (see FORTRAN manual). 
Push P format scale (see | 
FORTRAN manual). : | 
JSR PC,S$DCI. | 


Returns 4 word result on top of 
stack. 


$DCO (61) SD 5 JPC Double precision to ASCII 
: conversion. Calling sequence: 

Push address of start of ASCII 
field. 
Push length in bytes of ASCII 
field (W part of W.D) 
Push D part of W.D (position of 
decimal point). 
Push P scale. 
Push 4 word value to be convert- 
ed, lowest order word first. 
JSR PC,S$DCO. | 








ans gunt n 





NAME 


— 


DCOS 


DEXP 


$DI 


SDINT 


DLOG 


DLOG1O 


$DR 


DSIN 


DSQRT 


$DVD 


$DVI 


$DVR 


52 


40 


47 


23 


(24) 


PKG ARGU 
D k 
D l 
SD 
D 1 
D 1 
D 1 
1 
D a 
D a 
D 2 
2 
S 2 


Polish 


Polish 


J5RR 


J5RR 


Polish 


J5RR 


J5RR. 


Polish 


Polish 


Polish 





DESCRIPTION 


Calculates the cosine of its double 
precision argument and returns the 
double precision result in RO-R3. 


Calculates the exponential of its 
double precision argument, and 


returns the double precision result 
in RO-R3. 


Converts double precision number on 


-the top of the stack to integer. 


Leaves result on stack. 


ors internal function to find the 
integer part of a double precision 
number. 


Double precision (4 word) version 
of ALOG. 


Double precision (4 word) version 
of ALOG10. 


Replaces the double precision item 
at the top of the stack with its 
two word, rounded form. 


Calculates the sine of its double 
precision arg. and returns the 
double precision result in RO-R3. 


Calculates the square root of its 
double precision arg. and returns 
the double precision result in 
RO-R3. jA 

The double precision division 
routine. Divides the second 4-wor 
item on the stack by the top item 
and leaves the quotient in their 


place. 


The integer division routine. 
Calculates 2(SP)/@SP and returns 
the integer quotient on the top of 
the stack. 


The single precision division 
routine. Same as $DVD, but for 2 
word floating point numbers. 


NAME 
SECO 


SICO 


IDINT 


$ID 


IFIX 


OCTAL 


CODE 


(62) 


(67) 


(31) 


(5) 


(35) 


PKG 


SD 


SD 


SD 


# OF 


ARGU 


5 


MODE 
JPC 


J5RR 


JPC 
J5RR 
JPC 


JPC 


JPC 


J5RR 


Polish 


J5RR 


double precision. 


DESCRIPTION 


Single precision to ASCII 
conversion according to E format. 
Same calling sequence as $DCO 
except that a 2-word value is to be 
converted. 


Single precision version of DEXP. 
Returns result in RO,Rl. 


Internal OTS routine. 


Same as SECO except uses F format 
conversion. ' 


Returns in RO-R1, the real 
equivalent of its integer argument. 


Same as $ECO except uses G format 
conversion. 





ASCII to integer conversion 
calling sequence: 

Push address of start of ASCII 
field. 

Push length in bytes of ASCII 
field. . 

JSR PC,$ICI 

Returns with integer result on top 
of stack. 


Integer to ASCII conversion. 
Calling sequence: 

Push address of ASCII field. 

Push length in bytes of ASCII 
field. 

Push integer value to be converted 
JSR PC,$1CO 

Error will return with C bit set 
On. R0-R3 destroyed. 


Returns sign of arg T greatest 
integer <= |arg| in R0. Arg is 


Convert full word argument on the 
top of the stack to double 
precision and return result as top 
4-words of stack. 





Returns the truncated and fixed 
real argument in RO. 





| 


| 








OCTAL 
] NAME CODE 
INT (30) 
SINTR (27) 
SIR (4) 
$MLD 22 
A $MLI (20) 
S$MLR 21 
.SNGD (3) 
['suc1 (1) 
SNGR (2) 
-$0ct (66) 
| soco (70) 
| spans - 
| |$POPR3 - 
SPOPR4 - 


# OF 

PKG ARGU 
l 
S L 
SD l 
`D 2 
2 
S 2 
SD 2 
SD a 
SD L 
2 
3 
SD = 
D - 
D - 


MODE 
J5RR 


Polish 


Polish 


Polish 


Polish 


Polish 


Polish 
Polish 
Polish 


JPC 


Polish 


Polish 


Same as ID 
args. 


Same funct 


DESCRIPTION 


INT for single precision 


ion as AINT, but called 


in Polish mode with argument and 


yeturns re 


Convert fu 
top of the 
cision and 
2-words of 


Double pre 


sult on the stack. 


11 word argument on the 
stack to single pre- 
return result as top 
stack. 


cision multiply. 


Replaces the top two doubles on 
the stack with their product. 


Integer mu 
2 integers 
full word 


Single pre 
Replaces t 
stack with 


Negate the 
on the top 


Negate the 
the stack. 


Negate the 
on the top 


ASCII to O 


ltiply. Replaces the top 
on the stack with their 
product. . 


cision multiply. . 
he top two singles on the 
their product. 


double precision number . 
of the stack. 


integer on the top of 


single precision number 
of the stack. ~ 


ctal conversion. Same 


call as S$ICI. 


Octal to ASCII conversion. 


Some 


call as $ICO. 


Called whe 
enter Poli 
in-line co 
via a JSR 


Internal r 
from the S 
RO,R1l. 


Internal r 
from the S 
RO-R3. 


never it is desired to 
sh mode from normal — 
de. It must pe called 
R4,$POLSH. 


outine to pop 2-words 
tack and place them int: 


outine to poP 4-words 
tack and place them in 





$PSHRI 


(7) 


(10) 


15 


13 


36 
(33) 


46 


50 


# OF 


PKG ARGU 


D =~ 


SD 


SD 


MODE 
Polish 





Polish 


Polish 
Polish 
Polish 
Polish 
JPE 


Polish 


Polish 


Polish 


Polish 
J5RR 


J5RR 


J5RR 
J5RR 


routine. 


DESCRIPTION 


Internal routine to pop 4-words 
from the stack and place them in 
registers RO-R3. 


Internal routine to push the 
contents of RO onto the stack. 


Same as S$PSHRI. 
Push RO,Rl onto stack. 
Push RO-R3 onto stack. 
Same as $PSHR4, 


ASCII to single precision 
conversion. Same calling sequence 
as SDCI. Returns 2-word result on 
top of stack. 


Converts the single precision 
number on the top of the stack to 
double precision format. Leaves 
result on stack. 


Converts single precision number on 
the top of the stack to integer. 
Leaves result on stack. 


The double precision subtract 
Subtracts the double 
precision number on the top of the 
stack from the second double 
precision number on the stack and 
leaves the result on the top of the 
Stack in their place. 


Same as $SBD but for single 
precision. 


Single precision version of DSIN. 


Rounds double precision argument to 
single precision. Returns result 
in RO,Rl. 


Single precision version of DSQRT. 


Single precision hyperbolic tangent 
function. Returns (EXP(2*ARG)-1)/ 


(EXP (2*ARG)+1) in RO,RI1. 














G.2  NON-OTS ROUTINES 


These routines are written especially for FPMP-11 and should not be 


called directly by the user. 





OCTAL 

NAME CODE PKG DESCRIPTION 

SERR - SD Internal error handler. 

SERRA - SD Similar to S$ERR. 

SLOR 74 S Load FLAC, single precision. 

s153 72 D Load FLAC, double precision. 

STR a3 S Store FLAC, single precision. 

$STD 74 D Store FLAC, double precision. : 
TRAPH - SD The TRAP handler routines and 


tables. 


G.3 ROUTINES ACCESSED VIA TRAP HANDLER 

The following is a table of the FPMP-11 routines which can be accessed 
via TRAPH, the trap handler. Each routine name (entry point) is 
oreceded by its TRAP code number to be used to access it, and followed 


by a brief description of its operation when called via the TRAP 


handler. Those entries which are preceded by an asterisk (*) perform 
operations only on the FLAC, and address no operands. For example, a 
TRAP call to the single precision square root routine can be coded as 


follows: 


The net effect of the above TRAP instruction is to replace the 
contents of the FLAC with its square root and then set the condition 
ecées to reflect the result. Note that since the FLAC is implicitly 
acadressed in this instruction, the TRAP call supplies no other address. 
or.such a TRAP call, the addressing mode bits (bits 6 and 7 of the 
TRAP instruction) are ignored. 

G-8 


-— - we - - — 


All entries not marked by an asterisk require an operand when called. 


The operand is addressed in one of the 4 addressing modes explained in 
section 3.1.1. of the FPMP-11 User's Manual. The addressing mode is 


Specified in bit 6-7 of the TRAP instruction. 


("Operand" is the contents of the location addressed in the TRAP call.) 





OCTAL 
CODE 
14 
12 

x 26 

x 53 

E 54 

* 42 
16 
17 

- 37 

* 44 

* 52 

* 55 

* 56 

* 41 


NAME 


SADD 
SADR 
AINT 


ALOG 


ALOG10 
ATAN 


$CMD 


$CMR 
COS 
DATAN 
DEXP 


DLOG 
DLOGl10 
DCOS 


o pemean e cmm 


DESCRIPTION 


Double precision addition routine. Adds 
operand to the FLAC. Assumes 4-word 
operand. 





Single precision addition routine. Adds 
operand to the FLAC. Assumes 2-word 
operand. 


Replaces contents of the FLAC by its integer 
art. SIGN(FLAC) * greatest integer <= 
TFLAC| . Assumes 2-word argument in FLAC. 


Replaces contents of the FLAC by its natural 
logarithm. Assumes 2-word argument in FLAC. 


Same as ALOG, except calculates base-10 log. 


Replaces contents of the FLAC by its 
arctangent. Assumes 2-word argument in 
FLAC. 


Compares operand to the contents of the 
FLAC, and returns the following condition 
codes. 

FLAC«operand, N=1,42=0 

FLAC-operand, N-0,Z2-1 

FLAC>operand, N-20,2-0 


Assumes 4-word operands. 


Same as $CMD, but for 2-word operands. 
Same as DCOS, but for 2-word argument. 
Same as ATAN, but for 4-word argument. 


Replaces the contents of the FLAC by its 
exponential.  Assumes 4-word argument in 
the FLAC. 


Same as ALOG, but for 4-word argument. 
Same as ALOG10, but for 4-word argument. 


Replaces the contents of the FLAC by its 
cosine. Assumes 4-word argument in the 
FLAC. 





ee ee ee ee ed 


OCTAL { 
CODE NAME DESCRIPTION 
* 40 DSIN Same as DCOS, but calculates sine instead 
of cosine. 
* 47 DSQRT Replaces the contents of the FLAC by its 
square root. Assumes 4-word argument in the 
FLAC. 
23 $DVD Double precision division routine. Divides 


the FLAC by the operand and stores the 
result in the FLAC. Assumes 4-word operands. 


25 SDVR Same as SDVD, but for 2-word operands. 

* » OA EXP Same as DEXP, but for 2-word argument. 
72 SLDD Same as $LDR, but assumes 4-word operand. 
TL SLDR Replaces the contents of the FLAC by the 


operand.  Assumes 2-word operand. 


22 MLD Double precision multiplication routine. 
Multiplies the contents of the FLAC by the 
operand and stores the result in the FLAC. 
Assumes 4-word operands. 


2l SMLR Same as $MLD, but for 2-word operands. 


is $SBD The double precision subtraction routine. 
Subtracts the operand from the contents EA 
Be i of the FLAC. Assumes a 4-word operand. 





13 SSBR Same as SSBD, but for 2-word operand. 

* 36 SIN Same as DSIN, but for 2-word argument. 

* 46 SQRT Same as DSQRT, but for 2-word argument. 
74 $STR Stores the contents of the FLAC into the 


operand location. The contents of the 
FLAC are unchanged. 


74 $STD Same as SSTR, but assumes 4-word operand 
location. 
^ 50 TANH Replaces the contents of the FLAC by its 
hyperbolic tangent.  Assumes 2-word 
argument. 


APPENDIX I 


ASSEMBLING THE PAL-11A ASSEMBLER 


The following procedures are for assembling the PAL-11 Assembler 
source tapes. An 8K version of the PAL-11A (V007A) Assembler 
is required, thus also requiring at least an 8K PDP-11 system. 


The Assembler consists of two programs. The first program, 
on tape l, is a memory clear program and is very short 
(DEC-ll-UPLAA-A-PAl). The second program is the Assembler proper, 
and consists of eleven ASCII tapes (DEC-11-UPLAA-A-PA2-PAI12) . 


They are assembled as follows: 


l. Generate a sufficient amount of blank leader tape. 


2. Assemble the memory clear program source tape 
(DEC-11-UPLAA-A-PA1) and assign the binary output 
to the high-speed punch. For example, PAL-l1A's 
initial dialogue to specify the 2-pass assembly 
would be: 


"s n 

*B H/E 

FL 

eT 

€ (PAL assembly - lst pass) 
END? 


(PAL assembly - 2nd pass) 
ggg ERRORS (No errors - Do not remove 
the binary tape from the punch.) 


3. Assemble the rest. of the Assembler's source tapes 
(PA2 - PAl12) in numerical sequence. 


Assign the binary output to the high-speed punch. For 
example, the initial dialogue should be answered as 





follows: 
*5.'H 
*B H/E 
WE, 
*T 
EOF ? (Enter tape PA2 for lst pass) 
EOF. ? (End of tape PA2, enter PA3) 
EOF ? (End of tape PA3, enter PA4) 
EOF ? (End of tape PA4, enter PA5) 
EOF ? (End of tape PA5, enter PA6) 

















EOF ? (End of tape PA6, enter PA7) 

EOF ? (End of tape PA7, enter PA8) 

EOF ? (End of tape PA8, enter PA9) 

EOF ? (End of tape PA9, enter PAL10) 

EOF ? (End of tape PALO, enter PAILL} 

EOF ? (End of tape PAl1, enter PAl12) 

MAXCL3 = ****** SIMBC = **k*X5* (End of first pass) 

END ? 

EOF ? (Enter tape PA2 for 2nd pass) 

EOF ? (End of tape PA2, enter PA3) 

EOF ? (End of tape PA3, enter PA4) 

EOF ? (End of tape PA4, enter PAS) 

EOF 7? (End of tape PA5, enter PA6) 

EOF ? (End of tape PA6, enter PA7) 

BOF ? (End of tape PA7, enter PA8) : 
EOF ? (End of tape PA8, enter PA9) | 
EOF ? (End of tape PA9, enter PAI10) 

EOF ? (End of tape PA10, enter PALL) 

EOF ? (End of tape PALL, enter PAl12) 


JygygZZ ERRORS (End of 2nd pass) 


Note that at the end of the first pass there are two 
undefined symbols:  MAXC13 and SIMBC. These undefined symbols 
are resolved so that there are no errors reported during the 


second pass. 


Be sure that there is sufficient blank trailer tape on 
the binary output tape before removing the assembled tape from 
the punch. 


Normally, using high-speed paper tape input and output, 
this process requires about 45 minutes. If a symbol table and 
listing are requested, there will be about 750 symbols and about 
4500 lines of listing. 
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APPENDIX H 


TAPE DUPLICATION 


Duplication of paper tapes can be accomplished via low- or high- 


speed I/O devices by toggling (as with the Bootstrap Loader) the follow- 


ng program directly into memory through the Switch Fegister. (Refer to 


.l.l in Chapter 6 if necessary, for toggling procedure.) 


Turn on appropriate device switches ang place tape in 
desired reader. 


Set ENABLE/HALT switch to HALT. 


Set Switch Register to the desired starting address 
and press LOAD ADDR. 


Set Switch Register to each value listed in the CONTENTS 
column below, lifting the DEP switch after each setting. 
(Addresses are automatically incremented.) The desired 
input device (either Low- or High-Speed Reader) and out- 
put device (Low- or High- Speed Punch) are specified.in 
the last two words. 


ADDRESS CONTENTS EN 


0 016700 
2 000024 
4 016701 
6 000022 
10 005210 
12 105710 
14 100376 
16 105711 
20 100376 
22 022021 
24 Ux. PRIULI 
26 000764. 
30 177560 (LSR) or 177550 (HSR) 
32 177564 (LSP) or 177554 (HSP) 


Set Switch Register to starting address specified in 
3 above and press LOAD ADDR. 


Set ENABLE/HALT switch to ENABLE. 
Press START switch. 


NOTE 





This program is recommended as a simple way of 
duplicating the system tapes. However, for ex- 
tensive tape duplication, the program shown in 
section 7.8 is recommended. 
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Abbreviation 


ABS 
AD 
ADC 
ADRS 
ASCII 


APPENDIX J 
STANDARD PDP-11 ABBREVIATIONS 


Definition 


absolute 

analog-to-digital 

add carry 

address 

American Standard Code 
for Information Inter- 
change 

arithmetic shift left 

arithmetic shift right 

automatic send/receive 


byte 

bus address register 

bus busy 

branch if carry clear 
branch if carry set 
branch if equal 

bus grant 

branch if greater or equal 
branch if greater than 
branch if higher 

branch if higher or sanie 
bit clear 

bit set 

bit test 

branch if less or equal 
branch if lower or same 
branch if less than 
branch if minus 

branch if not equal 
branch if plus 

branch 

bus register data 

bus request 

back space 

bus shift register 

back space record 

busy 

branch if overtlow clear 
branch if overflow set 


Abbreviation 


CBR 
CLC 
CLK 
CLN 
CLR 
CLV 
CLZ 

CMP 
CNPR 
CNTL 
COM 
COND 
CONS 
CONT 


CSR 


Definition 


console bus request 

clear carry 

clock 

clear negative 

clear 

clear overflow 

clear zero 

compare 

console nonprocessor request 
contro} 

complement 

condition 

console 

contents 

continue : 

central processor 

control and Status register 


data 

digital-to-analog 

device address register 
data in 

data in, pause 

data out 

data out. byte 

data buffer register 
decoder 

destination effective address 
decrement 

Digital Equipment Corp. 
delay 

deposit 

deposit flag 

divide 

direct memory access 
device select 

destination 


` display. X-deflection register 


SS eee a | ee eee ee a ee OR ee ee ee eee A 


Abbreviation Definition Abbreviation Definition 
EMT emulator trap LSB least significant bit 
fl | ENB enable LSBY least significant byte 
: EOF end-ol-file LSD least significant digit 
EOM end-of-medium 
ERR " error MA . memory address 
EX external MAR memory address register 
EXAM E examine MBR memory buffer register 
EXAMF examine flag MEM memory 
EXEC execute ML memorv locatiori 
EXR external reset MOV , move 
MSB x most significant bit 
F flag (part of signal name) MSBY | | mostsignificant byte 
FCTN function MSD most significant digit 
FILO | first in, last out MSEL memory select: 
FLG flag MSYN master sync 
GEN generator | ND - negative driver 
NEG negate 
INDIVR integer divide routine NOR normalize DF 
INC increment — NPG nonprocessor grant 
increase NPR nonprocessor request 
INCF  . increment flag NPRF nonprocessor request flag 
IND indicator "> NS negative switch 
. INH inhibit 
INIT initialize ODT . octal debugging technique 
INST instruction OP operate i 
INTR : interrupt ' Operation 
INTRF - interrupt flag OPR operator 
lo input/output operand 
IOT input/output trap 
10X input/output executive routine PA parity available 
IR instruction register PAL . program assembly language 
IRD instruction register decoder PB parity bit 
ISR instruction shift register PC d program counter 
PD positive driver 
JMP jump PDP programmed data processor 
JSR jump to subroutine PERIF peripheral 
PGM program 
LIFO last in, first out PP . paper tape punch 
LKS line time clock status register PPB paper tape punch buffer register 
LOC -location , : PPS paper tape punch status register 


LP line printer PR paper tape reader 








Abbreviation 


PRB 


PROC 
PRS 


SRC 
SSYN 


Definition 


paper tape reader buffer 
register 

processor 

paper tape reader status 
register 

processor status 

positive switch 

priority transfer 


Abbreviation 


ST 
STPM 
STR 
SUB 
svc 
SWAB 


paper tape software system 


punch 


read 

reader 

register 

release 

reset 

rotate left 

read-only memory 
rotate right 
rotate/shift 

return from interrupt 
return from subroutine 
read/write 

read/write shift register 


single 

selection acknowledge 
subtract carry 

single cycle 

source effective address 
set carry 

select 

set negative 

set overflow 

sign extend 

set zero 

single instruction 
stack pointer 

spare 

switch register 

source 

slave sync 


o> 


"- 7. 4 I n we 





Definition 


start 

set trap marker 
strobe 

subtract 
service 

swap byte 


trap address 

track address 

temporary 

teletype keyboard 

teletype keyboard buffer register 
teletype keyboard status register 
teletype printer 

teletype printer status register 
trace trap 

timing state control 

test i 


user trap 
vector 


word count 
word count register 


X-line driver 
X-line read control group 
X-line write control group 


Y-line driver 
Y-line read control group 
Y-line write control group 


cpooX nuts rb a moo eomm mor T7 


Kel 


0000 


to to 


0000 


0 i 2 


————— MÀ ——À 


00000000 0001 0002 
001010008 0009 0010 
0020 C018 0017 0018 


APPENDIX K 


CONVERSION TABLES 


OCTAL-DECIMAL INTEGER CONVERSIONS 


3 4 5 $ 3 


0005 
0013 
0021 
0023 


0003 
0011 
0019 
0027 


0004 
0012 
0020 
0028 


0400 
0014 0015! 0410, 
0022 0023) 0420 
0030 


0006 0007 | 
| 





0256 0257 0258 0259 
j0264 0265 0266 0267 
!o272 0273 0274 0275 


0261 
0269 
0277 
0285 


ae es oA 






0262 
0270 
0218 
0236 


0263 
0271 
0279 
0281 


0777 
(Octal) 


0511 0030/0024 0025 0025 
(Decimat): 004010032 0033 0034 
0950;0040 0041 0042 


0031 j| 0430 | 10280 0281 0282 0281 
0039 || 0440 | 0282 0289 0290 0291 0232 
0041 ! 0450 [0235 0297 2298 0299 0300 










0293 
0301 


0035 
0043 


0936 
0044 


0037 
0045 


0038 
0046 


0234 
0302 


0295 
0303 


Octa! Decimal 
10000. 4096 
20000. 8192 
30000 - 12288. 
40000 - 16384 
50000 - 20480 
60000 -24576 
70000 - 28572 


0512 
to 
1023 


1000 


to 
1777 
(Octal) 


(Oecimal) 


.2080:0048 0049 0050 
.0010|0056 0057 0058 
f 

l or00j0084 0065 0066 
'9110}0072 0073 0074 
, 0120/0080 0081 0082 
:0130|0088 0089 0090 
[0140)0096 0097 0098 
|0150,0104 0105 0106 
0180|0112 0113 0114 
0170|0120 0121 0122 


,0200|0128 0129 0130 
0210!0136 0137 0138 
0220/0144 0145 0146 
,0230|0152 0153 0154 
0240,0180 0161 0162 
0250 |c168 0189 0170 
0260/0176 0177 0178 
0270/0184 0185 0186 


0300} 0192 0193 0194 
0310/0200 0201 0202 
:0320|0208 0209 0210 
90330,0216 0217 0218 
9340:0224 0225 0226 


0350/0232 0233 0234 


0360; 0240 0241 0242 
0370 | 0248 0249 0250 





(1000/0512 0513 0514 
!1010|0520 0521 0522 

1020|0528 0529 0530 
' 103010536 0537 0538 
1040j0544 0545 0546 
0552 0553 0554 
0560 0561 0562 
0568 0569 0570 





0576 0577 0578 
0584 0585 0586 
112010592 0593 0594 
| 1130] 0600 0601 0602 
(1140/0608 0609 0610 
(115010616 0617 0618 
1160} 0624 0625 0626 
pm 0633. 0634 


1200} 0640 0641 0642 
1210; 0648 0649 0650 
1220} 0656 0657 0658 
(1230 0664 0665 0666 
1240} 0672 0873 0674 
|1250! 0680 0581 0682 
} 1260/0688 0689 0690 
1270 
1300/0704 0705 0706 
,1310/0712 0718 0714 
1320/0720 0721 0722 
1330/0728 0729 0730 
‘1340| 0736 0737 0738 
1350| 0744 0745 0746 
136010752 0753 0754 
11370} 0789 2161 0762 


0053 
008! 


0054 
0062 


005! 
0059 


0052 


0055 | 0460 
0060 


0063 || 0470 


0071 |} 0500 
0079 |! 0510 
0087 || 0520 


0069 
0077 
0085 


0067 
0075 
0083 


0068 
0076 
0084 


0070 
0078 
0086 


0304 0305 0306 0307 
0312 0313 0314 0315 


0320 0321 0322 0323 
0328 0329 0320 0331 
0336 0337 0338 0339 


0696 0697 0898 0 


0091 
0099 
0107 
0115 
0123 


0131 
0139 
0141 
0155 
0163 
0171 
0179 
0187 


0195 
0203 
0211 
0219 
0227 
0235 
0243 
0251 


0092 
0100 
0108 
0116 
9124 


0132 
0140 
0148 
0156 
0164 
0172 
0180 
0188 


0196 
0204 
0212 
0220 
0228 
0236 
0244 
0252 


0093 
0101 
0109 
0117 
0125 


0133 
0141 
0149 
0157 
0165 
0173 
0181 
0189 


0197 
0205 
0213 
0221 
0229 
0237 
0245 
0253 


0094 
0102 
0110 
0118 
0126 


0134 
0142 
0150 
0158 
0166 
0174 
0182 
0190 


0198 
0206 
0214 
0222 
0230 
0238 
0246 
0254 


| 0255] 


0095 j 0530 0344 0345 0346 0347 
0103}; 0540 {0352 0353 0354 0355 
on |osso 0360 0361 0362 0363 
0113]|0560,0368 0369 0370 037! 


0127 pees 0377 0378 0379 


! 0600 |0384 0385 0385 0387 
0143|/0610|0392 0393 0394 0395 
01511/062010400 0401 0402 0403 
0159 |} 0630|0408 0409 0410 0411 
0167 |/ 0640] 0416 0417 0418 0419 
0175 |! 0650/0424 0425 0426 0427 
0183 {| 0660; 0432 0433 0434 0435 
0191 | 0670, 0440 0441 0442 0443 


0135 


0199 į | 0700 0448 0449 0450 0451 
0207 |: 0710!0456 0457 0458 0459 
0215 |/0720 0464 0465 0466 0467 
0223 0730/0472 0473 0474 0475 
0231 || 0740/0480 0481 0482 0483 
0239 10750 | 0488 0489 0490 0491 
0247 || 0760/0496 0497 0498 0499 
' 0770| 0504 0505 0508 0507 








AR 1 2 3 
0519 [ i400 0768 0769 0779 077! 


0527 || 1410,0776 0777 0778 0779 
0535}; 1420,0784 0785 0786 0787 
0543 | 1430; 0792 0793 0794 0795 
0551|} 14423,0820 0801 0802 0803 
0559 || 1450/0808 0809 0810 O8I1 
0567 1460| 0816 0817 0818 0819 
0575 pen 0824 0825 0826 0827 


0583|! 1500 ! o832 0833 0834 0835 
0591! | 1510:0840 0841 0842 0843 
0599| 1520 0848 0849 0850 085! 
0607| 1530 0856 0857 0858 0859 
0615||1540:0864 0865 0865 0867 
0623 1550; 0872 0873 0874 0875 
0631}; 1560'0880 0881 0882 0883 
06391 | 1510/0888 0889 0890 0891 


KAk 
0655: 
0663| 
0671 | 


160010896 0897 0898 0899 
161010904 0905 0906 0907 
1620 0312 0913 0914 0915 
1630/0920 0921 0922 0923 
11640 10928 0929 0930 0931 
Beye te 0937 0938 0939 
1660 0944 0945 0946 0947 
1670 ,0952 0953 9954 0955 


0679 
0687 
0695 | 
0703) 


| 
! 1700 '0960 0961 0952 0963 
(1710 0968 9969 0970 0971 
,1120,0976 0977 0978 0979 
| 1730 ;0984 0985 9986 0987 
174010992 0993 0994 0995 
175011002 1001 1002 1003 
176011008 1009 1010 1012 


(1770 | 1016 1C17T 1018 1019 


01 
0719| 
0727 
sns | 
074 

eu 
0159 
0161 













0364 
0372 
0380 


0388 
0396 
0403 
0412 
0420 
0428 
0436 
0444 


0452 
0460 
0468 
0476 
0484 
0492 
0560 
0508 


4 


0772 
0780 
0788 
0796 
0804 
0812 
0820 
0828 


0836 
0844 
0852 
0860 
0868 
0876 
0884 
0892 


0900 
0908 
0916 
0324 
0932 
0940 
0948 
0956 


0964 
0972 
0980 
0988 
0996 
1004 


1012 1 


1020 


0309 
0317 


0325 
0333 
0341 
0349 
0357 


0365. 


03173 
0381 


0389 
0397 
0405 
0413 
0421 
0429 
0437 
0445 


0453 
0461 
0469 
0471 
0485 
0493 
05601 
n509 


'0$02 


0310 
0318 


0311 
0319 









0227 
0335 
0343 
0351 
0359 
0351 
0375 
2383 


0326 
0334 
0342 
0350 
0358 
0366 
0374 
0382 


0390 
0398 
0406 
0414 
0422 
0430 
0438 
0445 


0391 
0399 
0407 
0415 
0423 
0431 
0439 
0441 


0454 
0462 
0470 
0478 
0485 
0494 


0455 
0463 
0471 
0479 
0487 
0495 
2503 
0510 








nt pie 


T——————— ÉÁÁÉÓÁHe( 


K,1 


2000 
to 
2777 
(Octal) 


70000 - 


3009 
to 
3777 
(Octai) 



















































30101359 1569 1570 1571 1572 1573 1574 1575 
3090/1576 1577 1578 1579 1580 1581 1582 1583 
3080 | 1584 1585. 1586 1587 1588 1589 1590 1591 
3070 | 1592 1593 1594 1595 1596 1597 1598 1599 


i 
3100 1600 1603 1602 1603 1604 1605 1606 1607 
3110/1608 1609 1610 1611 1612 1613 1614 1615 
3120;1616 1617 1618 1619 1620 1621 1622 1623 
2130 | 1624 1625 1626 1627 1628 1629 1630 1631 
3140, 1632 1633 1634 1625 1636 1637 1638 1639 
31501640 1641 1642 1643 1644 1645 1636 1647 
3160/1648 1649 1650 1651 1652 1653 1654 1655 
31701656 1657 1658 1659 1660 1651 1562 1663 


320011664 1665 1666 1657 1568 1669 1670 1671 
3210]|1672 1673 1674 1675 1676 1677 1678 1619 
322011680 1681 1682 1683 1684 1685 1685 1687 
32301688 1689 1690 1691 1892 1693 1694 1695 
1240/1695 1697 1698 1699 1700 1701 1702 1703 
3250 1704 1705 1706 1707 1708 1709 1710 1711 
3260 1712 )713 1714 1715 1716 1717 1718 1719 
13270 1720 1721 1722 1723 1724 1125 1726 1727 


3300 1728 1729 1130 1731 1732 1133 1734 1735 
3310 1736 1737 1738 1739 1740 1741 1742 1743 
3320 | 1768 1745 1746 1747 1748 1749 1750 1751 
[33301192 1753 1754 1755 1756 1757 1158 1759 
,3340,1750 1761 1762 1763 1764 1755 1766 1787| 
32350,1768 1769 1770 177] 1772 1773 1774 1775 


335011776 1777 1778 1779 1780 1781 1782 1783) 
[3370 | 1784 1785 1786 1787 1788 1189 1732 vn] 






OCTAL-DECIMAL INTEGER CONVERSIONS (Continued) 
la c£. 4 
| 1280 
2000 11024 
pi 20)0 | 1032 1288 
1535  12020|1040 1041 1042 1043 1044 1045 1046 1047 1296 
(Decimal) |2030/ 1948 1049 1050 1051 1052 1033 1054 1055 1304 
204011056 1057 1058 1059 1080 1061 1062 1063 1312 
2050:1054 1065 1086 1087 1088 1069 1070 1071 1320 1321 1322 1323 
12050,1072 1073 1074 1075 1076 1077 1078 1079 1328 1329 1330 1331 
Decimal di 1081 1082 1083 1084 1085 1086 1087]|2470!1336 1337 1338 1339 
4096 
ties 2100; 1088 1089 1090 1091 1092 1093 1094 1095]|2500| 1344 1345 1346 1347 
12288 2110/1096 1097 1098 1099 1100 1101 1102 1103/12510,1352 1353 1354 1355 
16384 2120/1104 1105 1106 1107 1108 1109 1110 1111/12520|1350 1361 1332 1363 
20480 213011112 1113 1114 1115 1116 1117 1118 1119/|2530]1368 1369 1370 1371 
24576 2140|1120 1121 1122 1:23 1124 1125 1126 1127]|2540,1376 1377 1378 1379 
28672 215011128 1129 1130 1131 1132 1133 1134 1135[|2550|1384 1385 1386 1387 
2160/1436 1137 1138 1139 1140 1141 1142 1143/(2560]1392 1393 1394 1395 
2170] 1144 1145 1146 1147 1148 1149 1150 1151 1400 1301 1492 1403 
2200 1152 1403 1409 1410 1411 
2210 | 1160 1416 1417 1418 1419 
2220; 1168 1424 1425 1426 1427 
2235, 1176 1432 1433 1434 1435 
2240! 1184 1440 1441 1442 1443 
2250 | 1192 1448 1449 1450 1451 
226011200 1456 1457 1458 1459 
2270| 1208 1464 1485 1466 1467 
2300 |1216 1472 1473 1474 1475 
2310 | 1224 1480 1481 1482 1483 
232011232 1488 1489 1490 1491 
233011240 1496 1497 1498 1499 
234011248 1504 1505 1508 1507 
2350 | 1256 1512 1513 1514 1515 
2360 | 1264 1520 
2310 1212 1528 
Ps d 3c. 9 4 B. ae 
1536  |3000,1536 1531 1538 1539 1540 1541 1542 1543 
to — |2010|1544 1545 1546 1547 1548 1549 1550 1551 
2047  |3020]1552 1553 1554 1555 1556 1557 1558 1559 
(Decimal) |3030|1560 1561 1562 1563 1554 1565 1566 1567 


1517” 


















K.l OCTAL-DECIMAL INTEGER CONVERSIONS (Continued) 





2304 2305 2305 2307 2308 2309 2310 2311 





4000 2048 |} 4900) 2048 2049 2050 2051 2052 2053 2054 2055||4400 
to to [4010| 2056 2057 2058 2059 2060 2081 2062 2053/|4410|2312 2313 2314 2315 2316 2317 2318 2319 
4777 2559 | 4020; 2064 2065 2065 2967 2058 2069 2070 2071) 442012320 2321 2322 2323 2324 2325 2328 3327) 


(Octal) i(Decirnai) | 4920; 2072 2073 2074 2075 2076 2077 2078 2079)| 4430! 2328 2329 2330 2231 2332 2333 2334 2335 








| 4040 2080 2081 2082 2083 2084 2085 2086 2087{|/4440) 2336 2337 2338 2339 2340 2341 2342 2343 
Octal Decimal j 4050] 2088 2089 2090 2091 2092 2093 2094 2095||4450]2344 2345 2346 2347 2348 2349 2350 2351 
10000. 4096. 4060! 2098 2097 2098 2099 2100 2101 2102 2103|/4460|2352 2353 2354 2355 2355 2357 2358 2359 
4070| 2104 2105 2106 2107 2108 2109 2110 2111||4470 





2360 2361 2362 2363 2384 2365 2366 2367 | 


39009 - 12288 faroo! 212 2113 2114 2015 2116 2117 2118 2119||4500|2368. 2369 2370 2371 2372 2373 2974 2375 
50000 - 20420 411012120 2121 2122 2123 2124 2125 2126 2127/1) 4510! 2376 2377 2318 2379 2380 2381 2382 2383 
60000 - 24576 412002128 2129 2130 2131 2132 2133 2134 2135||[4520|2384 2385 2386 2387 2388 2389 2390 2391 
60009- 24576 | 4130| 2136 2137 2138 2139 2140 2141 2142 214345302292 2193 2394 2395 2396 2397 2398 2399 
| 4140 2144 2145 2146 2147 2148 2149 2150 2151! {4540 2400 240! 2402 2403 2404 2405 2405 2407| 
415012152 2153 2154 2155 2158 2157 2158 2139/|14550,2408 2409 2410 2411 2412 2413 
4160| 2160 2161 2162 2163 2164 2165 21066 2167 45602416 2417 2418 2419 2420 2421 
4170| 2168 2169 2170 2171 2172 2173 2174 2175||4570|2424 2425 2426 2427 2428 2429 


4200] 2176 2177 2178 2179 2180 2181 2182 2183 FONS 2433 2434 2435 2436 2431 
421012184 2185 2186 2187 2188 2189 2190 2191 4610 | 2440 2441 2442 2443 2444 2445 
4220|2192 2193 2194 2195 2196 2197 2198 2199/|4620:2448 2449 2450 2451 2452 2453 
4230| 2200 2201 2202 2203 2204 2205 2206 2207/|4630,2456 2457 2458 2459 2460 2461 
1240; 2208 2209 2210 2211 2212 2213 2214 2215|14640:2164 2465 2466 2467 2468 2469 
4250; 2216 2217 2218 2219 2220 2221 2222 2223 4650; 2472 2413 2474 2415 2476 2417 
4260| 2224 2225 2226 2221 2228 2229 2230 2231/|4660,2480 2481 2482 2483 2484 2485 
4270] 2232 2233 2234 2235 2236 2237 2238 2239,|4670:24B8 2489 2490 2491 2492 2493 


4300| 2240 2241 2242 2243 2244 2245 2246 2247114700 2496 2497 2498 24939 2500 2501 
4310] 2248 2749 2250 2251 2252 2253 2254 2255] |4710/2504 2505 2506 2507 2508 2509. 
432012256 2257 2258 2259 2260 2261 2262 2263]|4720 2512 2513 2514 2515 2516 2517 
4330|2264 2265 2266 2267 2268 2289 2270 2271) /4730| 2520 2521 2522 2523 2524 2525 
4340) 2272 2273 2274 2275 2276 2277 2278 2219||4740,2528 2529 2530 2531 2532 2533 
4350| 2280 2281 2282 2283 2284 2285 2286 2287| /4750/ 2536 2537 2538 2539 2540 2541 
4360! 2288 2289 2290 2291 2292 2293 2294 2295] 14760; 2544 2545 2546 2547 2548 2549 
— 2301 2302 2303, (4770) 2552 2553 2554 2555 2556 2557 | 








| 

| 

l 

| 

| 

5000 2560 5000! 2560 2561 2562 2563 2564 2555 2556 25857/15400;2816 2817 2818 2819 2820 2821 2822 2823 
to to 5010/2568 2589 2570 2571 2572 2573 2574 2575) 5410|2824 2825 2826 2827 2828 2829 2830 2831 
5777 3071 5020/2576 2577 2578 2579 2580 2581 2582 2583; {5420/2832 2833 2834 2835 2836 2837 2838 2839 
(Octal) | (Decima!) 5030; 2584 2585 2586 2587 2588 2589 2590 2591||5430|2840 2841 2842 2843 2844 2845 2846 2847 
$040) 2592 2593 2594 2595 2598 2597 2598 2599//5440|2848 2849 2850 2851 2852 2853 2854 2855 

5050/2600 2601 2602 2503 2804 2605 2606 2607,|5450,2856 2857 2858 2859 2860 2861 2862 2863 
5060/2608 2809 2610 2611 2612 2613 2614 2615||5460,2864 2865 2866 2867 2868 2869 2870 2271 
5070/2616 2617 2618 2619 2620 2621 2622 2623) |5470) 2872 2873 2874 2875 2876 2877 2878 2879 








5100 | 2624 2625 2626 2627 2628 2629 2630 2631) {5500 ,2880 2881 2882 2883 2884 2885 2886 2887 
5110) 2632 2633 2634 2635 2636 2637 2638 2633|[5510,|2888 2889 2890 2891 2892 2893 2894 2895 
5120/2640 2641 2642 2643 2644 2645 2646 2647) |5520/ 2896 2897 2893 2899 2900 2901 2902 2903 
5139/2648 2649 2650 2651 2652 2653 2654 2655) |5530| 2904 2905 2906 2907 2908 2909 2910 2911 
5140} 2656 2657 2658 2659 2660 2651 2662 2663/15540 2912 2913 2914 2915 2316 2917 2918 2919 
515012664 2665 2666 2667 2668 2669 2670 2$71|]5550/2920 2921 2922 2923 2924 2925 2926 2927 
5160/2672 2673 2674 2675 2676 2677 2678 2679) /5560/2928 2929 2930 2331 2932 2933 2934 2933 
5170:2680 2681 2682 2683 2684 2685 2686 2687|,557012936 2937 2938 2939 2940 2941 2942 2945 


$200 | 2688 2689 2690 2591 2692 2633 2694 2695 5600 | 2944 2945 2946 2947 2948 2949 2950 295! 
521012695 2697 2698 2699 2700 2701 2702 2703/,5610;2952 2953 2954 2955 2956 2957 2958 2959 
522012704 2705 2706 2707 2708 2709 2710 2711,|5620, :2960 2961 2962 2963 2964 2965 2966 2967 
523912712 2713 2714 2715 2716 2117 2718 2719 5630 | 2958 2969 2970 297; 2912 2973 2974 2915 
$240 12720 2721 2722 2723 2124 2725 2726 2127||5640/2916 2977 2978 2979 2980 2981 2982 2983 
$250!2728 2729 2730 2731 2732 2733 2734 2735|]5650|2584 2985 2986 2987 2928 2989 2990 2991 
1526012736 2737 2738 2739 2740 2741 2742 2143||566012932 2993 2594 2995 2996 2997 2998 2999 
5270:2744 2745 2746 2747 2748 2749 2750 2751|į5670|3000 3001 3002 3003 3004 3005 3006 3007 


4300/2752 2753 2754 2755 2756 2757 2758 2759) ieee [3009 3009 3010 3011 3012 3013 3014 3015 
5310[2760 2761 2782 2763 2764 2765 2766 2767; (5710 ,3016 3017 3018 3019 3020 3021 3022 3023 
5320/2168 2169 2770 2771 2772 2773 2774 2175| 5720! 3024 3025 3026 3027 3028 3029 3030 3031 
Sao araa 2117 2778 2119 2780 2781 2782 | 51730,3032 3033 3034 3035 2036 3037 3038 3039 
5340/2184 2785 2786 2787 2188 2789 2790 2791; 15740) 3040 3041 3042 3043 3044 2045 3046 3047 
$250|2792 2193 2794 2795 2796 2797 2198 27991|5150|3045 3049 3050 3051 3052 3053 3054 3055! 








; $380|2800 2801 2802 2803 2804 2805 1| 3058 3059 1080 3061 3062 3063 
15310|2308 2809 2810 2811 2812 2813 2814 2815||5770| 3084 3085 3066 3067 3968 3069 3070 307) 
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1 30000 - 
i 
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$280 
[ 
| 
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ARES ERN LEG PI 


14900 : 3072 
to 16910 ' 3080 

6777 3583 6020 3088 
Octal) | (Decima , $030 3096 
| i (8249. 3194 
8050 2112 
16980. 3120 
|5070 3128 
H 


18109 
$110 
6120. 
18130 
!6142 
$150 
15162 
18110 


| 6000 | 3072 
to 


Octa! Decima! 
10000. 4096 
26090. 8192 
12288, 
16384 
20480 
24576 
28672 


3136 
3144 
3152 
3160 
3168 
3116 
3134 
3132 


40000 - 
50000 - 
60000 - 
70000 - 


3200 
3208 
3218 
3224 
3232 
3240 
3248 
3256 


6200 
£210 
'8210 
5230 
6240 
6250 


5210 
t 
$300 
$310 
"4320 
5330 
6349 
£350 
5360 
6370 


3284 
'3272 
3280 
3288 
3296 
3304 
3312 
3320 


3073 
3081 
3089 
3091 
3105 
3113 
3121 
3129 


3074 
3082 
3090 
3098 
3196 
3114 
3122 
3130 


3137 
3145 
3153 
3161 
3169 
3177 
3485 
3193 


3138 
3148 
3434 
3162 
3170 
3178 
3185 
3194 


3201 
3209 
3211 
3225 
3233 
3241 
3249 
3251 


3202 
3210 
3218 
3226 
3234 
3242 
3250 
3258 


3266 
3274 
3282 
3290 
3238 
3306 
3314 
3322 


3265 
3273 
328% 
3289 
3297 
3305 
3313 
3321 


3075 
3983 
3091 
3039 
3107? 
3115 
3123 
33 


3139 
3147 
3155 
3153 
3171 
3173 


3197 3 


3135 


"3202 ; 


3211 
3219 
3221 


3235 3 


3243 
3251 
3233 


3267 
3275 
3283 
3281 
3299 
3307 
3315 
3323 


3071 
3085 
3093 
3101 
3109 
3117 
3125 
3133 


3141 
3149 
3157 
3165 
3173 
3181 
3139 
3191 


3205 
3213 
3221 
3229 
3231 
3245 
3253 
3281 


3269 
3277 
3285 
3293 
3301 
3309 
3317 
3325 


3078 
3085 
3094 
3102 
3110 
3118 
3126 
3134 


3142 ! 


3150 
3158 
3166 
3174 
3182 
3130 
3198 


3206 
3214 
3222 
3230 
3238 
3246 
3254 
3262 


3270 
3278 
3286 
3294 
3302 
3310 
3318 
3328 3327, 





3159] 


3167 
3175 
3183 
3131 
3199 


3207 
3215 
3221 
3231 
3239 
3247 
3255 
3263 


327) 
3279 
3287 
3295 
3303 
3311) 
2919) 
3327 





(8370 3320 3321 3322 3323 3323 Seo 1929 A5 
i 0 1 2 3 4 5 6 7 | 


7000 f 
to 
7777 
(Octal) 


3584 
to 

4095 |7929] 3500 
(Decima!) | 7530, 3608 
+040, 3816 

1050! 3624 
mu, 3632 
7910 3640 


(oo s asas asas 1947 2000 2569 2590 3591| 
(oo s asas asas 1947 2000 2569 2590 3591| 





1100: 3848 
jie 3656 

7120) 3664 
7130] 3672 
7140! 3680 
| 7150, 2688 
| 1160! 3698 
17170) 3704 





nao] 312 
pe 3720 
17220) 3728 
| 7230; 3738 
?240| 3744 
122501 2752 


3602 
3810 
3618 
3626 
3634 

3642 


3601 
3609 
3617 
3625 
3633 
3641 


3650 
3658 
3668 


3649 
3657 
3665 
3873 3674 
3881 3682 
3889 3890 
3897 3658 
3705 3706 


3114 
3122 
3130 
3137 3738 
3745 3746 
3183 3754 


313 
3721 
3029 


3782 
3770 


| 7359) 3780 3761 
17270) 3768 3769 





3778 
3715 
3794 
3802 
3810 
3818 
3826 
3334 


3777 
3785 
3733 
3801 
3809 


| 1300] 3778 
[1310] 3784 

7320| 3792 
2320| 2800 
7340! 3008 
i152 81$ 3817 
| 130] 9424 2825 


1370 3832 7 3333 








: 7010; 3592 3593 3594 3595 


2603 
3611 
3619 
3621 
3835 
3643 


3651 
3559 
3881 
3875 
3583 
3691 
3699 
3707 


3715 
3723 
3731 
3739 
3747 
3155 
3183 
3771 


3779 
3787 
3795 
3803 
3811 
3819 
3327 
3335 





3584 3585 3586 3587 3588 3589 3590 3591 


3596 3597 3598 3599 


3604 3605 
3612 3613 
3620 3621 
3628 3629 
3636 3637 
3644 3645 


3652 3652 
3660 3661 
3668 3663 
3616 3677 
3684 3685 
3692 3693 
3700 3701 
3708 3709 


3718 3717 
3724 3725 
3732 3733 
3140 3141 
3748 3749 
3153 31751 
3784 3565 
3772 3773 


3780 3781 
3788 3789 
3796 3797 
3804 3805 
3812 3813 
zias mas amo wen 3821 


3606 
3614 
3622 
3630 
3638 
3646 


3654 
3662 
3670 
3678 
3686 
3694 
3702 
3110 


3718 
3728 
3734 
3742 
3150 
3758 
3768 
3774 


3782 
3790 
3798 
3808 
3814 
3822 


3607 
3615 
3623 
3631 
3639 
3647 


3655 
3663 
3671 
3679 
3581 
3695 
3103 
3111 


3119 
3727 
3135 
3743 
351 
3159; 
3787 
3775 


3783 
379i 
3799 
3801 
3815 
3823 


3828 3829 2830 383i 
3838 3537 zias mas amo wen 3339 


K-4 








6400! 3328 
6410} 3336 
6420} 3344 
54301 3352 
5140, 3260 
6450: 3368 
6460, 3376 
6410] 3384 
! 
6500! 3392 
6510: 3400 
6520; 3408 





16530' 3416 


,6540, 3424 


16550. 3432 


| 


76550 3440 


16570 3448 


i 


i 


l 
6600 3456 
6610, 3464 
6620 3472 


:6630 3480 
16540 3488 


$ 


1 


i 


' 


i 












7710 


7740 


6650. 3496 
6660) 3504 
6670, 3512 


6700 3520 
6110 3528 
6720} 3536 
6730! 3544 
61401 2552 
6750| 3560 
6760' 3568 


(6110; 3876 


7400) 3840 
7410! 3848 
7420! 3856 
7430! 3864 
7440: 3872 
7450| 3880 
7460) 3888 
1410| 3896 


7500 | 3904 
7510] 3912 
7520| 3920 
7530 į 3928 
7540| 3936 
7550 | 3944 
7560| 3952 
7570 | 3960 


1600 | 3968 
7620 | 3976 
7620 | 3984 
7630 | 3992 
| 7840 | 4000 
| 1850 | 4008 
7680 | 4016 
7670 | 4024 
7700 14032 
4040 
4048 
4058 
4064 
4012 
4089 
4088 


17120 
17130 


7150 
7160 
7770 





OCTAL-DECIMAL INTEGER CONVERSIONS (Concluded) 





3329 
3337 
3345 
3353 
3351 
3369 
3371 
3385 





3393 
3401 
3409 
3417 
3425 
3433 
3441 
3449 


3457 
3465 
3473 
3481 
3489 
3497 
3505 
3513 


3521 
3529 
3537 
3545 
3553 
3561 
3569 
3571 








3842 
3850 3851 


3841 3843 
3849 
3851 
3865 
3873 
3881 
3889 


3897 


3858 
2866 


3859 
3867 
3874 3815 
3882 3883 
3890 3391 
3898 3899 


3907 
3915 
3923 
3911 
3939 
3941 
3955 
3963 


3905 
3913 
3921 
3929 
3937 
3945 
3953 
3961 


3906 
3914 
3922 
3930 
3938 
3946 
3954 
3962 


3976 
3978 
3986 
3994 
4002 
4010 


3971 
3979 
3987 
3995 
4003 
4011 


3969 
3977 
3985 
3993 
4001 
4009 


4017 
4025 


4033 
4041 
4049 
4051 
4065 
4073 
4081 
4089 


4018 
1028 


4034 
4042 
4050 
4058 
4066 
4074 
4082 
4030 


4019 
4027 


4035 
4043 
1051 
4059 
4067 
4075 
4983 
4081 








ER — 


Ke2 POWERS OF TWO 


. POWERS OF TWO 


— ae QU EET ls 


CCS IST DEN 


MOU d CO NJ © a 


9 n 


1 
N 


3 


ooooooor: 
oooo-muo 
- G) 0 NO 


Un 


ec 
oo 


22280 
888 


8 


0 
0 
0 
0 
0 
0 
9. 
0 
o. 
0 
0 
0 


ooooo 
$9888 


=... > ST 








K.3 SCALES OF NOTATION 


SCALES Vr Nio 


x,3,1 2* In Decimal 


x 2 x 2" x 2 
0.001 1 00069 33874 6258! 0.01 1.00695 55500 56719 0.1 1.07177 35625 35293 
0.002 1.00138 72557 11335 0.02 1.01395 94797 90029 0.2 1.14869 83549 97035 
0.003 1.00208 16050 79633 0.03 1.02101 21257 07193 0.3 1.23114 44133 44916 
0.004 1.00277 64353 01078 0.04 1.02811 33266 56067 0.4 1.31950 79107 72894 
0.005 1.00347 17485 09503 0.05 1.03526 49238 41377 0.5 1.41421 35623 73095 
0.006 1.00416 75432 38973 0.06 1.04246 57608 41121 0.6 1.51571 65665 10398 
0067 1.00486 33204 23785 9.07 1.04971 66836 23067 0.7 1.62450 47927 12471 
0.008 1.00556 05803 98468 0.08 1.05701 80405 61380 0.8 1.74110 11265 92248 
0.009 1 00625 78234 97782 0.09 1.06437 01824 53360 0.9 1.86606 59330 73615 
K.3,2 lo# In Octal 
10° n 107 10 n 10^ 
1 0 1.000 000 000 000 000 000 00 112 402 762 000 10 0.000 000 000 006 676 337 66 . 
* 12. 1 0.063 145 314 631 463 146 31 1 351 035 564 000 11 0.000 000 000 000 537 657 77 
144 2 0.005 075 341 217 270 243 66 16 432 451 210. 000 12 0000 000 000 000 043 136 32 
1750 3 0.000 406 111 564 570 651 77 22} 411 634 §20 000 13 0.0 000 000 000 003 411 35 
23 420 4 0.000 032 155 613 530 704 15 2 657 142 036 440 000 14 0.000 000 000 000 000 264 11 
303 240 5 0.000 002 476 1132 610 706 64 34 327 724 461 500 000 15 0.000 veo 000 000 000 022 01 
3 641 100 6 0000 000 206 157 364 055 37 434 157 115 760 200 000 1$ 9.000 000 000 000 000 001 63 
46 113 200 7 0000 0900 0:5 327 745 152 75 5 432 127 413 542 400 000 17 0.000 000 000 000 000 000 14 
575 360 400 8 9.000 000 001 257 143 561 05 67 405 553 164 731 000 000 18 0.000 000 000 000 000 000 0l 
7 346 545 000 9 0.000 000 000 104 560 276 41 
K.3.3 n log 2 and 10 In Decimal 
n n logio 2 n log; 10 n nlogo2 — n log; 10 
1 0.30102 99957 3.32192 80949 6 1.80617: 99740 19.93156 85693 
2 0.60205 99913 6.54385 61898 LÁ 2.10720 99696 23.25349 66642 
3 0.90308 99870 9.965578 42847 8 2.40823 99653 26.57542 47591 
4 1.20411 99827 13.28771 23795 9 2.70926 99610 29.89735 28540 
5 1.50514 99783 16.60964 04744 10 3.01029 99566 33.21928 09489 


K.3.4 Addition and Multiplication, Binary and Octal | `.. 
Multiplication `. 







Addition 
Binary Scale 
020-0 — i 0x0-0 
01-21-4071 ox1-21x0-20 
141-710 1x1^721 
Octa! Scale 
0 05 06 07 





1 0s 07 10 

2 o6 07 10 11 

3 07 10 1l 12 

4 10.34. 12 13 

5 131 12 13 14 

6107 10 Linx 1e 13 14 15 

34110 n Te 13 14 15 16 

K 3.9 Mathematical Constants In Octal 

s = 311037 552421 e = 2.55760 521305 Y= 0.44742 147707, 
g-! = 0.24276 301556; e!- 0.27426 530661s in y. = — 0.43127 233602; 
Vr = 1.61337 6110671 Ve = 1.51411 230704: log: y = — 0.62573 030645, 
Int = 1.11206 404435, logo e = 0.33626 7542511 V2 = 1.2404 746320i 
logi 7 = 1.51544 1632231 log: £ = 1.34252 1662451 in 2 = 0.54271 02776014 
vio = 3.12305 407267, logr10= 3.24464 741136,  1n10— 2.23273 067355, 


K-6 


APPENDIX L 


NOTE TO USERS OF SERIAL LA3U 
AND 6fg, 129%, AND 2499 BAUD VT@5'S 


The serial LA37 requires that filler characters follow each carriage 
return; the 699, 129g, and 2499 baud VTg5's require that filler char- 
acters follow each line feed. The following table lists the filler 
characters needed. The byte at location 44, has been established as 
the filler count and the byte at location 458 contains the character 
to be filled. These locations are initially set to zero by PAL-11A 
and ED-11 to allow normal operation of the program. 


Depending on the terminal, change the locations as follows: 


Loc 44 Loc 45 Resulting Word (binary) 


LA3g Bil, Kis. 999g1191999g19g1 
VTØ5 69g Baud ffl, — #12, 9899191999999g9l ~~ 
VTj5 1299 Baud $2, gi2,  89989191097099g1g 
Vrg5 2499 Baud 994, G12, 299919199909g19g 


The proper binary word can be stored at location 44, by using the 
console switches as described in section 2.1.2 of this manual. 
Furthermore, users with a 2499 baud VT@5 should avoid the use of 
vertical tab characters in their programs. Vertical tabs will not be 
properly filled and may cause characters to be lost. 


Once the changes have been made, the program may be dumped to paper 
tape by using the bootstrap version of DUMPAB (see section 6.3 in 
this manual). 


The above changes only affect output to the console teleprinter. 

Users of IOX or IOXLPT source tapes will find the byte at location 44. 
tagged "I.44:" and the byte at location 45 tagged "I.45:". These 
locations are defined near the end of the second source tape and can 


be changed to appropriate values using ED-1l. 


ODT-ll uses the locations (44 and 45) but does not set them to zero 


initially. 
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INDEX 


Abbreviations, standard PDP-11, J-1 Assembling 


Absolute address, 1-12, 3-16, 9-3 
Absolute Loader, 6-1 
checksum error, 6-12 
loading into core, 6-8 
operation, 6-10 
Start address, 3-23, 6-8 
summary, E-3 
Absolute mode of address, 9-3 
Absolute tapes, loading, 6-8, 6-9, 
G= rom: 
Accessing . 
registers, ODT-11, 5-7 
unstructured data, l-11- 
Access tables, random, 1-10 
Accumulator, 1-7 
Adding devices to IOX, 7-24 
ADD instructions, 1-8 
Addition operator, 3-9 
Address 
interrupt vectors, 1-15 
pointers, 1-8 
register display, 2-2 
Address, 
absolute, 1-12 
current byte, 3-10 
current. word, 3-10 
$ relative, l-12 
. ADDRESS light on switch register, 
2-4 
Address modes, see Modes 
Addressing, 1-6 
in assembly language, 3-11 
unstructured data, 1-7 
Addressing modes, operand, 1-7 
Advance command, 4-7 
Altering register contents, 9-7 
ALT MODE/ESC (Teletype key), 2-7 
AND operator, 3-9, 5-12 


' (apostrophe) usage, PAL-11A, 3-10 


Arguments, ED-11, 4-2 


Arithmetic operators, PAL-11A, 3-9 


.ASCII assembly directive, 3-22 
ASCII A 
address mode, 7-8, 7-11 
character set, 3-2, A-1 
conversion, 3-10 
ASCII, formatted, 7-8 to 7-10 
Assembler, PAL-l11A see Program 
Assembly Language 
Assembler directive 
ASOCII; 3-22 
TENTE J-2134 3-31 
.EOT, 3-29 
DWwEND, 3220 
EVEN, 3-20 
.WORD, 3-20 
Assembler directives (pseudo-ops) 
misspelled, 3-21 
summary of, B-8 


ODT-11, 5-28 
PAL-11A assembler, I-1 
Assembly dialogue, 3-29 
Assembly language syntax, B-2 
Assembly listing specification, 3-24, 
3-31 ; 
Assembly location counter, PAL-11A, 
3-10 
Assignments, undefined direct, 3-26 
* (asterisk) symbol usage, 4-1 
@ (at) symbol usage, 3-17 © 
Autodecrement address mode, 1-8, 1-9, 
3-14 
Autoincrement address mode, 1-8, 1-3, 
3-13, 3-14 


* (back-arrow), ODT-11, 5-7 
(backslash), ODT-11X, 5-14 
Backspace paper tape punch, 2-8 
Bad Entry (ODT-11), 5-19 : 
Beginning command, ED-11, 4-7 
Binary mode of address, 7-11, 7-12. 
Blank operator field (PAL-11A), 3-21 
Bootstrap Loader, 6-1 through 6-7: 
loading into core, 6-3 
summary, E-1- . 
Bootstrap tapes, loading, 6-5 
Brackets, 
angle, 5-15 
square, 2-7 
Branching (ODT-11), 5-13 
Branch instructions, PAL-11A, 3-19, 
B-7 
Breakpoints, 5-8, 5-14, 5-20 
ODT-11X, 5-16 
repeat count, 5-11 
set in loop, 5-10 
B.SP (punch control), 2-8 
Buffer arrangement, data transfer 
commands, IOX, 7-4 
Buffer 
overflow, 7-9 
size, 7-5 - 
Buffering, double, 7-17 
Bus address register, 2-2 
BUS light, 2-3 
.BYTE assembler directive, 3-21, 3-31 
Byte 
addressing, 1-6 . 
count (IOX), 7-8, 7-12, 7-13 
instructions, 1-9, 1-13 


Calculating offsets, 
OQDT-11,:5-13 .- 
ODT-11X, 5-16 
Call,. subroutine, 1-4, B-8 
Carriage return character, 3-2, 7-9 


Kat 

















Central Processor 
priority levels, 1-5 


status register (PS), 1-4 
Change command, ED-11, 4-11 
Changing location 

ODT-11, 5-4 

ODT-11X, 5-14 
Character deletion 

IOX, 7-9 

PAL-11A, 3-24 
Character location pointer (dot), 

ED-l11, 4-3 
Character set 
ASCII, A-1 
PAL-11A, 3-2, B-1 


Characters loaded into printer memory, 


2-10 

Checksum, Absolute Loader, 6-12 
Checksum error, IOX, 7-7 
Checksummed binary data, IOX, 7-11 
Close out an edit, 4-9 
Closing location 

ODT-11, 5-4 

ODT-11X, 5-14 


Code, position independent (PIC), 9-2 


Coding techniques, 9-7 
Command 
grouping, ED-11, C-3 
mode, ED-11, 4-1 
repeat count, 5-17 
Syntax ODT, 5-2 
Commands 


buffer arrangement in data transfer, 


7-4 

delimiter, ED-ll, 4-2 

BOE, ED-11, 4-7 

ED-ll, 4-1 through 4-9, C-1 

Input/Output, ED-11, 4-4 

mark, ED-11, 4-7 

modify text, 4-1, C-2 

ODT-11, 5-4 through 5-26, D-1 

open, ED-ll, 4-4 

search, ED-11, 4-1 

single instruction mode, ODT- 11x, 

5-18 

see also the specific subject 
Comment field,.3-4- 
Condition codes in subroutines, 9-8 
Configuration of system, 2-1 
Conflict Byte/Word, 7-22, 7-23 
Conflicting devices 

IOX, 7-13 

PAL-11A, 3-26 
Console, PDP-1li, 2-1 
CONT switch, 2-3 
Control switch operation, 2-4 
Conversion, ASCII, PAL-11A, 3-10 
Conversion tables, K-1 
Core memory, loading and dumping, 6- 
Core memory requirements, 1-16 


= 


Countér, program, see Program counter 


CTRL key, Teletype, 2-7 
CTRL/P 


assembler restart, PAL-ll, 3-27 
ED-11, 4-12 
CTRL/U 
ED-1ll, 4-12 
IOX, 7-9 


Current byte/word address, 3-10 
Current status (PS), 1-15 


Data, addressing unstructured,1-7,1-11 


see also Modes of data address 
Data 
register display, 2-2 
transfers, IOX, 7-12 . 
Data transfer commands, buffer 
arrangement in, IOX, 7-4 


DAT (Device Assignment Table), 7- -2, 


7-3 

Debugging, see On-Line Debugging 
Techniques 

Default, .WORD, 3-21 


Deferred address modes, 1-6 
index, 1-10 
PAL-11, 3-13 through 3-18 ^^ 
relative, 1-12 
summary, 1-11 
Delete command, 
ED-11, 4-10 
IOX, 7-9 
Deletion of characters or Mus 
ED-11, 4-10, 4-11, 4-12 
IOX, 7-9 i 
PAL-11A, 3-24 
Delimiting character, 3-22, 4-2 
DEP switch, 2-3 
DESTINATION light, 2-4 


Device Assignment Table (AT), 7-2, 


7-3 
Device 
codes, IOX, 7-25 


dependent functions, IOX, 7-9, 7- 


7-12 

independence, 7-3 

interrupts, 1-5, 1-6, 1-14 

Specification, PAL-11A, 3-24 
Device Interrupt Table (DIT), 7-23 
Device Status Table (DST), 7-24 
Devices, conflicting 

IOX, 7-13 

PAL-11A, 3-26 
Devices, 

adding to IOX, 7-24 

multiple, 1-5 
Dialogue, PAL-11A 

assembly, 3-29 

initial, 3-23 
Direct access to stack, 1-10 


Direct assignment statement, PAL- - m, 


3-6, 3-7 





m. 


= — ii " s ’ — e 


Directives, assembler, see Assembler 
directives 

Direct memory devices, 1-5 

Bone Bit) LOX, 7-7, 7-15, 7226 

Dot (character location pointer) 
ED-11, 4-3, 4-5, 4-7, 4-8 

Double buffering, IOX, 7-17 

Double operand instruction, PAL-11A, 
3313; .B-4 

* (down arrow) symbol, ED-11, 4-2 

DUMPAB program, 6-12, 6-13, 6-14 

Dump program, 6-13 

Dumping core memory, 6-1 

DUMPTT program, 6-12, 6-13, 6-14 

Duplication of tape, H-1 


Echo suppression, 7-6 
ED-1i, see Text Editor Program 
EMT instructions, PAL-11A, 3-19 
ENABLE/HALT switch, 2-3 
.END (End of program)assembler direc- 
tive, 3-20, 3-30 
End command, ED-11, 4-7 
End-of-File bit (EOF), IOX, 7-8 
End of Medium bit (EOM) 
IOX, 7-7 
PAL-11A, 3-30 
End-of-Tape (EOT), PAL-11A, 3-19 
.EOT (End-of-Tape) assembler direc- 
tive, 3-29 
= (equal sign) usage, PAL-11A, 3-7 
Error codes 
nonfatal IOX, 7-6 
PAL-11A, 3-32, 3-33, B-8 
Error halts, software 
ED-11, 4-22 
PAL-11A, 3-33 
Errors, 
detection of, ODT, 5-18 
ED-11, 4-12 
fatal, IOX, 7-19 
listing, 3-24 
PAL-11, 3-32 
phase, 3-8 
typing, 3-24 
ESCape key (Teletype), 2-7 
Evaluation of expressions, PAL-11A, 
3-8 
.EVEN assembler directive, 3-20 
EXAM switch, 2-2 
Examine a specific location, 2-4 
Exchange commands, ED-11, 4-11 
Exclusive OR (XOR), 5-12 
EXECUTE light, 2-3 
Expressions, PAL-11A, 3-8 


EETCH Eight, 2-3 
Fields, PAL-11A 
comment, 3-4 
instruction operand, 3-18 


Fields, PAL-11A (cont.) 
label, 3-3 
operand, 3-4 
operator, 3-3 
Floating-Point Math Package (FPMP-11), 
9-1, Gal 
Format control, PAL-11A, 3-4 
Formatted ASCII, address mode, IOX, 
7-8 to 7-10 
Formatted binary address mode, IOX, 
7-11, 7-12 
Form feed character, 3-4, 4-7 
Form feed command, ED-11, 4-7 
Forms of addressing, 1-13 
Forward references, 3-7, 3-8, 3-11 
FREE (Reader control), 2-7 
Functional organization, ODT, 5-29 
Functions, ODT, 5-4 through 5-26. 


General registers, accessing, ODT-11, 
5-7 í 

Get command, ED-11, 4-8 

Go command, ODT-11, 5-10 l 

Grouping of Text Editor commands, C-3 


Halts, software error 
ED-11, 4-22 
PAL-11A, 3-33 
High speed reader/punch, 2-9: 


I.CONFLC table, 7-26 
I.CONSIT table, 7-26 
I.DST table, 7-26 
I.FUNC table, 7-25 
I.INPUT routine, 7-27 
I.INTAB table, 7-26 
I.OUTPUT routine, 7-27 
I.SCRAAB table, 7-25 
Immediate address mode, 1-12, 3-15 
Incrementation of program counter, 3-12 
Index address mode, 1-10, 3-15, 9-4 
deferred, 1-10, 3-15 
Index register, 1-7 
Indicator lights,. 2-3 
Indicators and switches on console, 2-1 
Infinite loop, ODT-11, 5-10 
Initial dialogue 
ED-11, C-4 
PAL-11A, 3-23, 3-29 
Initialize DAT slots (INIT), 7-4 
Initializing the system, 2-12 
Input/Output commands, ED-11, 4-4, C-i 
Input/Output Executive program (IOX), 
7-1 
buffers, 7-4 to 7-8 
data transfers, 7-12 to 7-18 
DAT (Device Assignment Table), 7-3, 
7-4 
errors, 7-19 
example program, 7-20 
internal information, 7-20 to 7-27 
modes, 7-8 to 7-12 
reenabling Reader,.7-18 
restarting, 7-19: 
summary, F-1 
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Insert command, ED-11, 4-9 
Instruction capability, 1-13 
Instruction mnemonics, 3-3: 3-6, 
3-219, 3-21 

Instruction offset, 5-13 
Instruction operand fields, 3-18 
Instruction set, 1-6 
Instructions, 

ADD, 1-8 

assembly language, B-3 

byte;.1-9 

pranch, 3-19 

double-operand, 3-13, B-4 


EMP 3a 9 
JMP, 3-13 
JSR, 3-13 


single, 2-5 

single operand, B-4 

TRAP, 3-19, 5-22, 5-23 
Internal register, accessing, ODT, 

5-7 

Interrupt routines, I01,77997 
Interrupt vectors, 1-6 

address, 1-15 

setting up, 9-5 
Interrupts, device, 1-5, 1-14 
I/O device specification, 3-24 
IOX, see Input/Output Executive 
IOXLPT, the conflict word, 97-22, 7-23 


JMP instructions, PAL-11A, 3-13 
JSR instruction, PAL-11A, 3-13 
Jump command, ED-11, 4-7 


Keyboard, Teletype, 2-7 
IOX functions, 7-9, 7-11 

Keys, 

RUBOUT, 3-24, 4-12, 7-9 

Kill command, ED-11, 4-10 


Label field, PAL-11A, 3-3 
Leader/trailer tape, 2-8 
LIFO (Last-In-First-Out), a9 
Lights on switch register, 2-3 
Lights operation, LPll line printer, 
2-11 

LINE control, Teletype, 2-6 
Line deletion 

ED-11, 4-10, 4-11, 4-12 

IOX, 7-9 

PAL-11A, 3-24 
LINE FEED key; 4-2, 5-5, 5-15 
Line Printer (LP11), 2-10 

Buffer (LPB); 2-10 

function (IOXLPT only), 7710 
Line terminator, 4-3 


-List commands, ED-11, 4-4, 4-6 


List errors on teleprinter, 3-24 


a 


Listing 
PAL-11A assembly, 3-31 
octal/symbolic, 3-1 
LOAD ADDR switch, 2-2 
Loader, 
Absolute, 6-8 through ó- 
Bootstrap, 6-2; 6-3, 6-4 
Loading 
Absolute Loader into core, 6-8 
absolute tapes, 6-8 through 6-10 
assembler, 3-23 
Bootstrap Loader into core, 6-3 
characters into printer memory, 2-10 
and dumping core memory, 6-1 
Editor (ED-11), 4-13, C-4 
ODT, 5-27 E 
PAL-11A, 3-23 
paper tape: 2-8, 2-9 
unused tape vectors, 9-6 
Load paper tape LSR, 2-7 
Local control. Teletype, 276 
Locating breakpoint, ODT-11, 5-9 
Location change 
ODT-11, 5-4 
QpT-11x, 5-14 
Location counter, PAL-11A, 3-10 
Location references; ODT-11, 5-3 
Logical operator, PAL-11A,..379 
Loop, infinite, 5-10 
LPll Line printer, 2-10, 2-11 
Low-Speed Punch and High-Speed Punch, 
ED-11, 4-7 
TOX; 7-19 
Low-Speed Reader and High-Speed 
Reader, 7-10 


IU 


Mark, ED-11, 4-3, 4-5, 4-8 
Mask of search specification, ODT-11, 
5-11 

Mathematical conversion tables, K-1 
Memory requirements, 1-16 

Misspelled assembler directive, 3-21 
Mnemonic, instruction, 3-3; 3-6, 3-18, 

misspelled, 3-21 


Modes of data address, 1-7 through 1-12 


absolute; 1-12, 3-16, 9-3 
byte, 7-5 
index, 9-4 
IOX, modes, 7-8 through 7-12 
ODT, 5-17 
PAL-11A modes, 3-12 through 3-16 
position independent, 9-2 : 
summary, 1-11 
Mode forms and codes, 3-17 
Modify Text commands, ED-1l, 4-9, C-2 
Multiple devices, 1-5 
Multiple operands, 3-22 : 
Multiply-defined symbols, 3-3, 3-26 


Negative numbers, 3-9 
Nested device servicing, 1-14,.1-16 
Next command, ED-11l, 4-7 
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Non-deferred address modes, 1-8 


summary, 


Non-deferred autoincrement mode, l- 


ESTE 


Non-deferred index mode, 9-4 
Nonexistent command, 
Non-fatal error codes, IOX, 7-6 
Non-Processor Request level, (NPR), 


e 


Null character, 
Numbers, PAL-11A, 3-9 
negative, 3-9 
truncation of, 


Object programs, 
Octal/decimal conversion tables, K- -l 
Octal/symbolic listing, 3-1 
ODT-11, see On-Line Debugging Tech- 


nique 


OFF control, 
OFF (UNLOCK) 


T9 


9-9 


ge 


Offsets, 5-13 to 5-16 
On-Line Debugging Technique 


Program, 


assembling, 5- 


breakpoints, 5- 


commands, 5-4 
command syntax, 5-2 
error detection, 5- 
functions, 5-4 
functional organization, 5-20 
loading procedures, 
5-14 through 5-24 
open locations, 5-4 
program runaway, 5- 


Search, 


Starting and restarting, 5-27, 


summary, 


5-] , 


5-11 


D71 


28 
20 


ON-LINE light, LPli, 
ON-LINE/OFF-LINE switch, LPll, 


ON (LOCK ON) 


ED-1l, 4-1. 


Teletype, 2-6 
(punch control), 2- 


18 


5-24 


24 


2-11 


8 


5- 


"ES 


(punch control), 2-8 


ON/OFF (main power) switch, LPl1, 
2- 


Open addressed location, ODT-liX, 


5-15 


Open command, ED-11, 4-5 
Opening a location 


ODI-LL,. 
ODT-11X, 


5-4 
5-14, 


5-45 


Operand addressing modes, 1-7 
Operand field, 3-4, 3-18 
Operands, multiple, 3-22 
Operate instructions, 
Operating control switches, 2-4 
Operating High-Speed Reader/Punch 


units, 


2-8, 


2-19 


Operating procedures 
Dump program, 
ED-11, 4-12, C-4 


ODpr-11; 
PAL-11A, 


S27 
3-73. 


6=13 


B=9 


PAL- 11A r 


B-6 


8 


(ODT-11 and ODT-11X),5-1 


28 


Operating Teletype, 2-6 
Operator field, PAL-11A, 3-3, 
blank, 3-21 
Operators, PAL-11A, 3-3, 3-8, 3-9 
Organization, functional, ODT, 5-20 
OR operation, 3-9 
Output formats, DUMPTT program, 6-14 
Output from DUMPAB program, 6-14 
Overflow, ED-11 . 
page buffer, 4-10, 4-12 
storage area, 4-5 
Overflow of buffer, IOX, 7-9 


Page buffer, ED-I1, 4-4, 4-10, 4-12 

Page size, PAL-11A, 3-4 

PAL-11A, see Program Assembly Language 

PAPER STEP switch, LP11, 2-11 

Paper tape creation, ED-11, 4-14. 

Paper tape reader. 
controls, 2-7 
loading, 2-8, 2-9 
punch (LSP), 2-8 

Parenthetical groupings of expressions, 

PAL-11A, 3-8 

Passes, assembler, 3-28 

Patching with TRAP handler, 9-14 

PDP-11 standard abbreviations, J-1 

$ (percent) symbol (register 

expression), PAL-11A, 3-8 | 

. (period) symbol, PAL-11A, 3-10 . 

Phase errors, 3-8 

Peripheral device interrupts, 1-6 

PIC (Position Independent Code) 

writing,. 9-2, 9-4- 

Pointer 
positioning commands, ED-11, C-1 
relocating, 9-6 

Pointer, address, 1-8 . 

Position Independent Code (PIC), 9-2 
writing automatic PIC, 9-4 : 
writing nonautomatic PIC, 9-5 

Position independent modes, 9-2 - 

POWER light (LP11), 2-11 

Printer, Teletype, 2-6 
control panel, 2-10 
loading characters: into memory, 

2-10 : 

Priority 
of central processor, 1-4 
level ($P), ODT-1ll, 5-14 

Priority levels, central processor, 

1-5 
Proceed command, ODT, 5-10, 5-17, 
5-23 

Processor priority levels, 1-4 
stack use, 1-14 

Processor Status Register, 1-4 

Processor Status word, 1-6 

Program Counter (PC), 1-6, 1-7, 1-12 
PAL-L1A; 3-11; 3-12 ” : 











Program start, 2-5 
Program value, 1-6 
Program Assembly Language (PAL-11A) 


assembling, I-1 

character set, 3-2, B-1 

error codes, 3-32, 3-33 

expressions, 3-8 

loading, 3-23 

numbers, 3-9 

software error halts, 3-33 

statements, 3-2 
Programs . 

object, 3-1 

source, 3-1, 3-2 
Program runaway ODT, 5-24 


Programming considerations, ODT, 5-19 

Programming techniques, 9-1 

PS (Central Processor Status 
Register), 1-4 

Pseudo-ops see Assembler directives 

Punch command, ED-11, 4-6 

Punch, Low Speed, 4-7 

Punch functions, 7-10 

Push down lists, 1-9 


? (question mark). usage, ED~1l, 4-1 
" (quotation mark) usage, PAL-114A, 
3-10 


Random access tables, 1-10 
Read command, 
ED-11, 4-5 
FOX, 7-12 
Reader functions, IOX, 7-10 
Reader/punch, high speed, 2-9 
Reader, reenabling and restarting, 
7-18 
Readr command (real-time Read), 
7-17 
READY light (LP11), 
Real-time 
capability, 
Read, IOX, 7-17 
Write, IOX, 7-18 
Recursive subroutines, 9-11 
References, forward, PAL-LIA, 
S- thee phil 
Register contents, altering, 
Register displays, 2-2 
Register expression ($), PAL-11A, 3-8 
Register mode, 1-7, 1-8 
PAL-11A, 3-12 through 3-18 
. Registers, 1-7 
symbol assignment, 1-7 
Register symbols, PAL-11A, 3-7 
Relative address mode, 3-16 
Relative addressing, 1-12 
ODT; 5-13 
Relative branch offset, 
«5-15 


IOX, 
273 
Tel 


3-7, 


9 


ODT-11X [i 


RElease (punch control), 2-8 
Relocating ODT, 5-29 
Relocating pointer, 9-5 
Repeat count L 
breakpoint, ODT-11, 5-11 
in proceed command, ODT-11X, 
5-17 


for single-instruction mode, 5-18 
Reserved storage area, 3-11 
Restart 
assembler, PAL-11A, 3-27 
command, IOX, 7-19 i 
ED-11, 4-13, 4-14, C-4 
ODT, 5-28 
Return previous sequence, ODT-11X, 
Serg ; ; 


Return subroutine, PAL-11A, B-8 
Return from Interrupt, (RTI) 

instruction, 1-15 - 
RETURN key, 4-2, 4-14 
Rotate shift instructions, PAL-11A, 

B-5 
RUBOUT key, 3-24, 4-12, 7-9 : ] 
RTI (Return from Interrupt) 

instruction, 1-15 
RUN light, 2-4 
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Search commands, ED-11, 4-9, C-2 
Search, ODT-11, 5-11 
address, 5-12 k 
limits of, 5-11, 5-12 
mask, ($M), 5-11 
word, 5-12, 5-25 " 
Seek command, 7-18 ; 
; (semicolon) usage, ODT, 5-3, 5-24 
Sequential address pointer, 1-7 | 
Serial LA3fÓ display, L-1 
Setting breakpoint, ODT-11, 5-8 
Setting up stack pointer, 9-5 
Setting up trap or interrupt 
vector, 9-5 i 
SHIFT/K (Teletype), 2-7 
SHIFT/M (Teletype), 2-7 
Single buffer transfer on one 
device, IOX, 7-16 
Single instruction mode, 2-5 ü 
commands, 5-18 
ODT-11X, 5-17 
repeat count, 5-18 
Single operand instructions, PAL-11A, 
B-4 
S-INST/S-CYCLE switch, 
Size of page, 3-5 
Slash (/) ODT-11, 
Software, 1-16 
error halts, 
ED-11, 4-22 
PAL-11A, 3-33 
SOURCE light, 2-4 


2-3 


5-4,05-5 


xm} 





Source program, 3-1, 3-2 
Space characters, PAL-11A, 3-4 
{ ] (square brackets), 2-7 
Stack operations, 1-9, 1-14 
Stack pointer (SP), 1-7 
setting up, 9-5 
tart program, 2-5 
START (reader control), 2-7 
START switch, 2-3 
Starting and restarting ODT, 5-27 
Starting Text Editor, 4-13, C-4 
Statement, PAL-11A, 3-2 
composition of, 3-3 
direct assignment, 3-6, 3-7 
Statement terminator, 3-2 
Status byte, IOX, 7-6, 7-12, 7-13 
pous Dt, 7-2, 7-155 7-16 
Status Register address ($S) symbol, 
ODT-11, 5-7 
Status register format, 1-4 
STOP (Reader control), 2-7 
Storage area overflow, ED-11, 4-5 
Storage area, reserved, PAL-11A, 
3-11 
Storage Maps, core memory, 
6-12, 6-15 
DUMPAB program, 6-16 
Storage requirements, ED-11, C-4 
Subroutine calls, 1-14, B-8 
Subroutines 
condition codes in, 9-8, B-8 
recursive, 9-11 
returns, 1-14, B-8 
Subtraction operator, 3-9 
Summary of 
Absolute Loader, E-3 
address modes, 1-11 - 
assembly language and assembler, 
PAL-11, B-1 
Bootstrap Loader, E-1 
FPMP-11 Floating-Point Math 
Package, 8-1, G-1 
IOX programming, F-1 
ODT-11 and ODT-11X, D-1 
Text Editor. (ED-11), C-1 
Suppress echo, 7-6 
Switches, 
console, 2-2 
EPIT, 2-11 
operating the control, 2-4 
switch register, 2-2 
Switch register, 2-2 through 2-5 
Symbols, PAL-11A, 3-5 


forward reference to register, 3-8 


multiple definition of, 3-3, 3-26 
permanent, 3-6 

register, 3-7, 3-8 

undefined, 3-7 

user defined, 3-6 

see also the specific subject 


Symbols, 


Status Register address, $S, ODT, 5-7 


Text Editor, ED-11, C-3 
Symbol table, PAL-11A, 3-26 
Symbols used in manual, see Preface 
Syntax, assembly language address 
mode, PAL-11A, B-2 
System, see specific. subject 


Tab, T0 7-9 
Tab characters, PAL-11A, 3-4 
Tables, 
modification of word, 7-25: 
random access, 1-10 ` 
Tape duplicatior, H-1 
Techniques, coding and programming, 
ot MI, Lr EE 
Teleprinter functions, 7-10 
Teletype hardware tab facility, 7-24 
Teletype interrupt, ODT, 5-26 
Teletype operation, 2-6 
Terminator statement, 3-2 
Terminator, text mode, 4-8 
Testing checksum, Absolute Loader, 6-8 
Text Editor Program (ED-11) 
character location pointer. (Dot), 
4-3, 4-7 
commands, 4-4 through 4-9 
deletion of characters or lines, 
4-10, 4-11, 4-12: 
delimiters, 4-2 
Dot, 4-3, 4-5, 4-7, 4-8 
error correction, 4-12 
example, 4-14 through 4-21 
loading, 4-13 
Mark, 4-3, 4-8 
operating procedures, 4-12 
paper tape creation, 4-14 
restarting, 4-14 : 
search commands, 4-8 
. starting, 4-13 
summary, C-i 
symbols, C-3 
Text mode, 4-l- 
terminator, 4-8 
Text modification commands, C-2 
Timeout, IOX, 7-17 
TOP OF FORM switch, LP11, 2-11 
Trace trap instruction, ODT, 5-22, 
5-23 
Trailer command, ED-11, 4-7 
Transfer commands, buffer mp 
ment in, IOX, 7-4 
Trap handler, patching with, 9-14 
Trap instructions, 3-19 
Opi, 5-22, 5-23 
PAL-11A, B-6 
Trap vectors, 3-33, 
loading unused, 9- 
setting up, 9-5 
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Traps; LFLS 
Truncation of numbers, PAL-11A, 3-9, : : 
3-19 
runcation of line, IOX, 7-7 
TTY SAVE routine, ODT, 5-26 
Typing errors, PAL-11A, 3-23 


Undefined direct assignments, 3-26 

Undefined symbols, PAL-11A, 3-7, 3-26 

Unformatted ASCII mode, IOX, 7-11 

Unformatted binary mode, IOX, 7-12 

Unibus, 1-5 

Unstructured data addressing, 1-7 

t (up arrow), ODT-11, 5-6, and 
ODT-11X, 5-15 


Value, program counter, 1-6 
Vectors, 
address interrupt, 1-15 
trap, 3-33, 9-7 
VTZ5 display, L-1 


Waitr (Wait Return) command, IOX, 7-14 
vs. testing buffer done bit, 7-15 
WHole (search command), ED-11, 4-9 
.WORD assembler directive, 3-20 
Word addressing, 1-6 
Word search, ODT, 5-12, 5-25 
Write command, IOX, 7-13 
‘Writing PAL-11A assembly language 
programs, 3-1 
Writing position-independent code 
(PIC), 9-2 
automatic, 9-4 
non-automatic, 9-5 
Writr (Real-time Write) command, IOX, 
7-18 








